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PREFACE 


Q@.1 MANUAL OBJECTIVES AND READER ASSUMPTIONS 


The RSX-11D System Manager ’s Guide is intended for the individual who 
has overall responsibility for the operation of an RSX-11D system. 


The system manager must have knowledge of RSX-11D in order to benefit 


from this guide. 


In particular, the system manager should consider 


the following documents prerequisites: 


RSX-11D Users Guide, 
RSX-11D Task Builder Reference Manual, 
RSX-11D System Generation Reference Manual. 


8.2 DOCUMENT STRUCTURE 


This manual comprises the following chapters: 


Chapter 


Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 


Chapter 


1 


1l 


Appendix A 


Appendix B 


Introduction to the manual and the significance of 
UICS and passwords, 


Operation of and output from task accounting, 
Use of spooling, despooling, and input spooling, 
Checkpointing, 

Global libraries and common areas, 

Core dump analysis, 

Time-scheduled partitions, 

Error logging, 

System management notes, 

Executive debugging aids, 

Parity support, 

Sample core dump analyzer output, 


TKB15.CMD file, 


ix 


Appendix C Error logging sample output and data _ record 
formats. 
Appendix D 11/70 parity error response 


9.3 ASSOCIATED DOCUMENTS 


Refer to the RSX-11D Documentation Directory, order number 


DEC-11-OXUGA-D-D for a description of associated RSX-11D documents and 
their readerships. 


CHAPTER 1 


INTRODUCTION 


The RSX-11D system manager is responsible for system features’ that 
fall into the following three categories: 


1. Coordination and accounting of the multiuser environment, 
2. Control of system operation, 
3. System reliability monitoring. 


The coordination of the multiuser environment consists of controlling 
the assignment and use of user identification codes (UICS) and their 
associated passwords as described in Section 1.1. UICsS and passwords 
uniquely identify system users and establish their access’ rights. 
UICS also provide the basis for the accumulation of accounting 
statistics on executing tasks. Accounting details system use on a 
task-by-task basis, as described in Chapter l. 


Control of system operation consists of such -features as output 
spooling and despooling of print files, input spooling of card files, 
the operation of checkpointing, and the implementation and use of 
global libraries and common areas. ; 


Output spooling and despooling improves system operation by 
eliminating individual task contention for printers, teleprinters, and 
other serial output devices. Input spooling allows tasks to process 
card files from the disk rather than requiring them to wait for card 
reader availability. Output spooling and input spooling are detailed 
in Chapter 3. . 


Checkpointing is the mechanism used to aid high priority tasks to 
obtain the memory they require to execute aS soon as possible after 
they are reguested. Lower priority tasks are checkpointed to disk to 
allow higher priority tasks to run. Chapter 4 describes this process. 


Global libraries are collections of routines that can be shared by 
many Simultaneously active tasks. Common areas are data areas in 
memory that can be shared by many simultaneously active tasks. Both 
global libraries and common areas are loaded into memory dynamically 
when needed and their memory is’ released when they are no longer 
required as described in Chapter 5. 


System reliability monitoring includes the core dump analyzer and _ the 
hardware error logging facility. 


The core dump analyzer provides a means of interpreting the state of 
the software when a system crash occurred. It is described in Chapter6é. 


Chapter 7 contains a description of the algorithm used in 
time-scheduled partitions. This information should be. taken into 
consideration when configuring a system that is to contain 
time-scheduled partitions. 


The error logging facility allows the system manager to obtain a 
detailed and/or summary report of peripheral device errors. Error 
logging reports can be produced for specified time frames and _ for 
specified devices or volumes, as described in Chapter 8. 


The system manager also iS responsible for optimizing system 
operation. Chapter 9 contains system management notes for that 
purpose. 


Executive trace and ODT are provided in RSX-11D for the debugging of 
user-initiated modifications to the Executive. These features are 
described in Chapter 18. 


Chapter 11 details the software support for handling hardware parity 
errors. This information should be used in conjunction with the error 
logging description in Chapter 8. 


1.1 UICS AND PASSWORD PROTECTION | 


Under RSX-11D, the key to controlling the multiuser environment is UIC 
and password assignment. Each system user should have a unique UIC. 
Each UIC is associated with a UFD on the system volume (SY). The UFD 
command, described in. Chapter 6 of the RSX-11D User’s Guide, is used 
to place UFDs on directoried devices. Any UFD placed on the SY volume 
also serves as a UIC. A UIC is not valid unless the same UFD exists on 
SY. 


The group code portion of the UIC is used to determine the privileges 
extended to the usSer once the user has logged onto the system. Any 
group code of 18 (octal) or less indicates a privileged UIC. Its owner 
is granted access to system functions as a privileged user. Group 
codes greater than 18 (octal) indicate a general user with restricted 
access to system functions. The terms general user and privileged 
user are defined in the RSX-11D User's Guide. The following are 
examples of privileged UICs: [1,12], [5,29] and [3,3]. 


UICS are specified in the HELLO command that allows a user to log onto 
the system. The HELLO command is detailed in Chapter 5 of the RSX-11D 
User’s Guide. The system validates UICs typed in the HELLO command to 
determine that the UIC is valid for the system. 


Each UIC can have a password associated with it. When passwords are 
used, once the user types the HELLO command, a request is printed on 
the terminal as follows. 


PASSWORD> 


The user types the password at this point. The password is not 
printed on the terminal as it is typed. If the password corresponds 
to the UIC specified in HELLO, the user gains access to the system. 


A UIC created by the UFD command does not have a password associated 
with it. The PWD command to MCR is used to assign a password if one 
is desired. The PWD command is detailed in Chapter 6 of the RSX-11D 
User’s Guide. 


When assigning UICS to system users, the system manager. should take 
into consideration the ways that UICS might be used. For example, if 
accounting is to be performed on tasks executing in the system, the 
UIC serves as the account number. The system manager should ensure 
that a meaningful system of assigning UICs is developed. 
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The RSX-11D system as distributed by DIGITAL contains privileged and 
nonprivileged UICs. These UICS are not password protected. The 
system manager can log on under any one of the privileged UICs_ to 
perform a system generation. The system manager can use the PWD 


command to assign passwords to any of the distribution system UICS as 
desired. 


NOTE 


All functions described in this manual 
must be performed by a privileged user. 


CHAPTER 2 


ACCOUNTING 


RSX-11D accounting provides the system manager with a means of knowing 
how the System resources are being used by executing tasks. 
Accounting provides statistics on a task~-by-task basis and also 
accumulates totals for each UIC (account). The user specifies at task 
build time whether accounting is to be performed for the _ task. 
Therefore, accounting information is accumulated only when the 
information is desired. 


2.1 INTRODUCTION 
Accounting statistics provide the following information for a task: 


1. The amount of computer memory used by a task in terms of 
32-word blocks, 


2. The elapsed execution time; i.e., time in memory, 


3. Central processor time used by the task indicated in clock 
ticks, 


4. The number and types of accesses to each peripheral device 
used by the task. 


Summary statistics contain totals for each UIC under which tasks 
specified for accounting are run. Figure 2-1 provides an example of 
task statistics and associated statistics. 


Elapsed time is total time starting when the task is first made active 
and ending when the task exits. The time between a suspend request 
and a resume request is included in the elapsed time. Interrupt and 
Executive overhead time for the task are included in both central 
processor time and elapsed time. 


Tasks that are requested more than once have a set of statistics for 
each time they execute. Each version of a multiuser task has a 
separate set of statistics. 
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ACCOUNTING REPORT FOR 19-FEB-75 TIME: 17:43:58 
ACCOUNTS FOR UIC [5,73] 
TASK: ..-FLX STARTED AT: 19-FEB-75 17:43:49:22 
CORE USED: CPU TIME: 
+415 +2 


ELAPSED TIME: 9-9-8 9:9:1:12 


DEVICE ACCESS SUMMARY : 


DEVICE: UNIT: READS: WRITES: 


DP g 7) 7) 


TT 7 1 1 
SUMMARY FOR UIC [5,73] 
CORE USED: CPU TIME: 
+415 +2 


ELAPSED TIME: 9-@-@ @6:9:1:12 


DEVICE ACCESS SUMMARY: 


+1 READS +1 WRITES | +4 OTHERS. 


Figure 2-1 Accounting Output : 
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Accounting provides data that can be used for billing based on 
computer usage. Because all accounting statistics are accumulated 
using UICS as account numbers, each account to be billed should be 
given a specific UIC or a related set of UICs so that statistics 
related to that account can be identified readily. 


In addition, the system manager should be aware of how the system uses 
UICs for various functions. For example, a task run by a_= general 
(nonprivileged) user executes under the UIC that was specified in the 
HELLO command. On the other hand, if the same task is run by a 
privileged user, it executes under the UIC for which it was built or 
the UIC specified using the /UIC= switch with the RUN command. The 
UIC for which the task was built is the one given in the UIC= command 
to the task builder or the value to which it defaulted. When using 
batch, the /ACC= option on the $JOB command dictates the UIC under 
which tasks within that job execute, as described in the RSX-11D Batch 
Reference Manual. 


Tasks which run at a priority above the priority of ACCLOG should NOT 
be built accountable. 


Privileged tasks should not be made accountable if there is any 
possibility that they might be terminated for time limit by ACCLOG 
while modifying system data. It is NOT recommended that any 
distributed task be built accountable, except for the non-privileged 
system utilities. A batch file is provided for this purpose (see 
Section 2.3.4). 


2.2 FUNCTIONAL DESCRIPTION 


The actual statistics for each task are accumulated by a set of system 
subroutines and placed in the task’s header area. Storing information 
in the task header means that statistics for a task usually need to be 
written to a disk file once only; i.e., when the task exits. 


Two accounting tasks are required to 1) log the accounting information 
into a permanent disk file, and 2) analyze the accounting and produce 
the final output files. 


2.2.1 Logging Task -- ACCLOG 


The logging task, ACCLOG, takes statistics from the task header when 
the task exits and writes that information in a disk-resident file. 


NOTE 


ACCLOG is a= privileged, high-priority 
task that must be running at a priority 
of 235 or greater for accounting to take 
place. 


ACCLOG creates two files on SY under UFD [1,5] in which statistics are 
stored. First, it opens and uses a file named ACCTS1.DAT and writes 
statistical data into it. When the analysis task runs, as described 
below, it sets global event flag 61 to indicate that it wants to 
process ACCTS1.DAT. ACCLOG tests the same _ flag. When it is set, 
ACCLOG stops updating ACCTS1.DAT and opens another file named 
ACCTS2.DAT. ACCLOG also sets global event flag 62 to indicate that 
analysis can proceed. 


ACCOUNTING 


When the analysis task runs again to process the second file, it sets 
a flag to indicate this fact. At that point, ACCLOG creates a file 
named ACCTS1.DAT. ACCLOG maintains two files: one to. store 
statistics in and one to be processed by the analysis’ task. ACCLOG 
alternates between creation of ACCTS1.DAT and ACCTS2.DAT. 


2.2.2 Analysis Task -- ACCRPT 


The analysis task, ACCRPT, analyzes the data file produced by ACCLOG. 
ACCRPT can be installed and run or scheduled at the user’s discretion; 
unlike ACCLOG, it need not be resident constantly. When ACCRPT 
executes, it analyzes all information in the data file. 


ACCRPT produces two files: a report file (ACCTS.RPT) that can be 
listed on a line printer and a data file (ACCTS.TOT) that can be 
processed by a usSer-written task, if desired. All files are under UFD 
[1,5]. Additionally, ACCRPT deletes the raw data file (ACCTS1.DAT or 
ACCTS2.DAT). 


The records in ACCTS.TOT are variable in length and contain octal 
information providing task and UIC statistics. Figures 2-2 and 2-3 
illustrate the fields and their lengths for task-specific and summary 
records, respectively. 


Each time ACCRPT executes, it resumes ACCLOG and sets an event flag to 
tell ACCLOG to open a new file. When the old file is closed, ACCRPT 
reopens it and begins processing the data on a UIC and task basis. 
When finished, ACCRPT deletes the input file (ACCTS1 or ACCTS2). 
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RECORD TYPE 


TASK NAME 


(RADIX 58) 


ELAPSED TIME 


PROCESSOR TIME 


IN TICKS 


DEVICE NAME (ASCIT) 


DEVICE 
ACCESS 


INFORMATION 


NUMBER OF OTHER ACCESSES 


NOTE 


1. The minimum record size is 14 words. 
The maximum is 119 words. 


2. The device access information is 
repeated once for each device used 
by the task. 

3. Except where noted, all information 
is in binary. 


Figure 2-2 Format of Task Statistics Record (ACCTS.TOT) 
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RECORD TYPE 


MEMORY USED IN 


32-WORD BLOCKS 


ELAPSED TIME 


PROCESSOR 


TIME 
IN TICKS 
TOTAL NUMBER 
DEVICE ‘ OF READS 
ACCESS TOTAL NUMBER 
INFORMATION OF WRITES 


TOTAL NUMBER OF 


OTHER ACCESSES 


NOTES 


The record containing UIC statistics is 
28 words in length. 


All information is in binary. 


Figure 2-3 Format of UIC Summary Records (ACCTS.TOT) 
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Each time ACCRPT runs, it creates new output files rather’ than 
updating the existing ones, thereby making it easier for the user to 
keep track of accounting information. It is the system manager’s 
responsibility to delete these files when they are no longer needed. 


If a system crash occurs, ACCRPT is not able to process the raw data 
file (either ACCTS1.DAT or ACCTS2.DAT) that was being used by ACCLOG 
when the failure occurred. However, the file remains on the disk and 
can be processed by the user. Figure 2-4 illustrates the record 
lay-out for the raw data file. 


2.3 OPERATIONAL INFORMATION 


Operational information describes 1) the procedures for initiating and 
terminating accounting and 2) the task builder and task installation 
requirements of the task to be accounted. Optionally, accounting can 
be performed for utility programs as described in this section. 


NOTE 


If the system clock is not running at 69 
(decimal) ticks per second, the analysis 
task (ACCRPT) must be rebuilt before it 
is used. 


To rebuild ACCRPT, first edit the file 
[11,26] RPTBLD.CMD by locating the 
following line. 

GBLDEF=TICKS:74 


Change the 74 (octal) to the correct 
number of ticks per second in octal. 
Then issue the following string to TKB. 


TKB>@[11,26] RPTBLD.CMD 


CPU TIME 


CORE USED 


START TIME 


DEVICE 

ACCESS 

(up to 16 of 
these fields 
can be present 


END TIME 
(Always last 
field of 
record) 
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TICKS 
SECONDS 


STARTED MINUTES 


SECOND 
MINUTE 
HOUR 
DAY 
MONTH 
YEAR 
1 (See Note 2) 
DEVICE NAME (ASCIT) 
UNIT NUMBER (OCTAL) 
READ COUNT 
WRITE COUNT 
OTHER COUNT 
5 (See Note 2) 


SECOND 
MINUTE 
HOUR 
DAY 
MONTH 
YEAR 


NOTES 


1. Uniquely identifies two tasks with 
the same UIC and name. 


2. Field type code. 


Figure 2-4 Record Format for Raw Data File 
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2.3.1 Initiating Accounting 


Use the following procedures to initiate accounting. 


1. If it has not been done already, mount the system disk using 
the MOU command and update the time and date using the TIM 
command. 


2. Run ACCLOG from a privileged UIC using the _ following 
commands. 


MCR>RUN ACCLOG 


At this point, the system is ready to start accumulating 
statistics. If tasks designated for accounting execute 
before ACCLOG runs, no statistics accumulate for them. 


3. When accounting statistics are desired, install and run 
ACCRPT using the following commands. 


MCR>INS [11,1] ACCRPT 
MCR>RUN ACCRPT 


4. When ACCRPT terminates, use PIP to print ACCTS.RPT. 
Additionally ACCTS.TOT can be printed using the DMP utility 
program. All files are on UFD [1,5]. 


2.3.2 Terminating Accounting 


Two separate tasks are provided to terminate accounting. The first, 
ACCABT, allows the operator to abort accounting for the entire system. 
The second, ACCOFF, allows the operator to terminate accounting in an 
orderly fashion. 


When ACCABT runs, it aborts ACCLOG and sets an internal switch to 
indicate that no further accounting is to be performed. It makes no 
attempt to finish the logging of information for tasks that have not 
terminated nor does it attempt to analyze information in the raw data 
file. 


On the other hand, ACCOFF first runs ACCRPT to _ preserve all 
accumulated data and then aborts ACCLOG. Normally, ACCOFF is used to 
perform an orderly shut down of accounting. ACCABT is used only in 
emergency situations to abort accounting. 


Regardless of which method is used to terminate accounting, it can be 
restarted at any time by following the procedures in Section 2.3.1. 


Use one of the following procedures to terminate accounting. 


1. To perform an orderly shut down, install ACCRPT and ACCOFF 
and run ACCOFF using the following commands. 


MCR>INS [11,1]ACCRPT 


MCR>INS [11,1]ACCOFF 
MCR>RUN ACCOFF 


2. To abort accounting, type the following commands. 


MCR>INS [11,1]ACCRPT 
MCR>RUN ACCABT 
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Both procedures cause a normal termination message to be printed on 
the terminal. Do not under any circumstances use ABO to abort ACCLOG, 
as it causes misinformation to be left in the system data base and 
could cause serious problems. Always use one of the above first. 


2.3.3 Task Requirements (/TA and /TIM) 


All tasks for which accounting information is to be accumulated must 
have accounting specified for them during task building. The /TA 
switch is used in the command strinq to specify accounting as 
described in the RSX-11D Task Builder Reference Manual. 


NOTE 


The default for the Task Builder can be 
changed so that /TA becomes the default. 
Refer to Chapter 9. 


Another option for controlling accounted tasks is the /TIM switch that 
can be used on the INS command to MCR. The /TIM switch allows the user 
to specify the amount of central processor time that a task can use. 
If the specified amount is exceeded, the task is aborted and its 
accounting information is recorded. The /TIM switch has the following 
format. 


/TIM=nx 


n is a decimal number indicating the number of time units (x) 
of central processor time that the task is allowed. 


x indicates the type of time unit and can _ be one of the 
following. 


H = hour 

M = minutes 
S = seconds 
T = ticks 


The amount of time specified must be no greater than 24 hours. For 
example, 24H, 1449M, and 864@@S are the maximum amounts“for hours, 
minutes, and seconds, respectively. 


If /TIM is not included and accounting is specified for the task, the 
maximum amount of processor time allowed is five minutes. If the task 
is still running after five minutes of processor time has been’ used 
and /TIM was not specified, the system aborts the task. 


2.3.4 Rebuilding Utilities to be Accounted 


The system manager can rebuild all the RSX-11D utility programs, 
MACRO-11, and the FORTRAN compiler to have their use accounted. To 
simplify the rebuilding process, a batch command file is included in 
the system to rebuild all utilities, MACRO-11, and FORTRAN. The _ file 
is located under UFD [11,26] and is called UTLACCBLD.BIS. After 
UTLACCBLD.BIS is processed by batch, the new task images are located 
under UFD [11,26]. 
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Use the following procedures to rebuild the utilities, MACRO-1l, and 
FORTRAN to be accounted. , 


1. Redirect SY to the device containing the system object files. 


2. Type the following command to request batch and process the 
file. 


MCR>BAT [11,26]UTLACCBLD 


If some, but not all, are to be accounted, the utility tasks, 
MACRO-11, and/or the FORTRAN compiler can be rebuilt 
individually. Table 2-1 lists the individual task build 
files to make a utility, MACRO-11, or FORTRAN accounted. All 
of the files are under UFD [11,26]. 


Table 2-1 
Task Build Files for Accounted System Tasks 


TASK BUILD FILE ASSOCIATED MODULE 


TKB@4ACC.CMD FLX 
TKB95ACC.CMD PIP 
TKB#6ACC.CMD SLIPR 


TKB#®7ACC.CMD Librarian 
TKB1#@ACC.CMD MACRO 
TKB11ACC.CMD Task Builder 
TKB20ACC.CMD Editor 
TKB41ACC.CMD ; FORTRAN 


2.3.5 Disk Storage Statistics 
The /TB switch for PIP can be used to obtain statistics on the amount 
of disk storage that is used for a UFD. To determine the amount of 
storage used by a UFD on a specific device, type the following command 
to PIP. 

PIP>dev: [ufd] /TB 

dev is the device for which statistics are desired. 


[ufd] is the UFD whose usage is to be determined. 


To determine the amount of disk storage used for all UFDs on a device, 
type the following command to PIP. 


PIP>dev: [* ,*] /TB 


2.3.6 Suggestions 


1. Run ACCRPT only when necessary. Random running of ACCRPT 
results in many report files (ACCTS.RPT and ACCTS.TOT). 
Normally, ACCRPT needs to be run only when the system is to 
be shut down. 


2. When the system is to be shut down, run ACCOFF rather’ than 
running ACCRPT and ACCOFF individually. ACCOFF automatically 
calls ACCRPT. 
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3. Use ACCTS.TOT as a basis for billing or further analysis. 
ACCTS.TOT is an octal file that can be processed by 
user-written tasks using FCS. 

4. If accounting is to be used for billing purposes, ensure that 
UICS are assigned to individual accounts in a meaningful and 
easily processed fashion. 

5. If many .TOT files are to be processed to produce one set of 


output, combine the .TOT files into one file using PIP. See 
the RSX-11 Utilities Procedures Manual. 


2.4 ERROR MESSAGES 

ACCLOG, ACCRPT, ACCOFF, and ACCABT issue error messages to the user. 
All of the accounting tasks assume that the SY handler is loaded, the 
device is mounted with correct access, and the device is not full. If 


this is not the case, error mesSages are printed on the terminal and 
the uSer must correct the situation. 


2.4.1 ACCLOG Error Messages 
ACCLOG -- FAILED TO OPEN NEW FILE, RUN ACCABT. 
Use the following procedures to correct the situation: 
1. Ensure that UFD [1,5] is present on the system disk, 


2. Ensure that ACCLOG was running under a privileged UIC so that 
it has correct access rights, 


3. If neither 1 or 2 above was the cause of the problem, check 
the device, 


4. Run ACCABT, 
5. Rerun ACCLOG. 
ACCLOG -- IO ERROR; SOME DATA LOST 


This message indicates that write errors have occurred and data has 
been lost for a task’s account. Use the following procedures: 


1. Check the file and device to see if they are usable, 
2. If the errors persist, run ACCOFF to preserve accumulated 


statistics and turn accounting off until the cause of the 
problem is fixed. 


ACCOUNTING 


2.4.2 ACCRPT Error Messages 
ACCRPT -- FAILED TO OPEN NEEDED FILE, CANNOT PROCEED 
filename 


If the filename specified in the message is ACCTS1.DAT or ACCTS2.DAT, 
use the following procedures: 


1. Ensure that ACCTS1 or ACCTS2 exists under UFD [1,5], 


2. Ensure that ACCRPT was run under a privileged UIC so that it 
has the correct access rights, 


3. Ensure that the file is closed properly and not locked, 


4. If none of the above is the cause of the problem, check the 
device, 


5. Rerun ACCRPT. 


If. the filename specified in the message is ACCTS.TOT, ACCTS.RPT, or 
ACCTS.TMP, use the following procedures: 


1. Ensure that ACCRPT is running under a privileged UIC so that 
it has correct access rights, 


2. Check the device, 
3. Rerun ACCRPT. 


If rerunning ACCRPT does not produce the desired results, use the DMP 
utility program to retrieve all data files except ACCTS.RPT. Use PIP 
to retrieve ACCTS.RPT or try to reanalyze the file. 


ACCRPT -- IO ERROR, SOME DATA LOST 
filename 


If the filename specified in the message is ACCTS1.DAT, ACCTS2.DAT, or 
ACCTS.TMP, some input data has been lost. One task’s account will be 
missing from the final analysis. Ensure that the file is not 
corrupted or the device is not malfunctioning. | 


If the error persists, stop analysis and print or dump all files under 
[1,5] to retrieve data and locate the problem. 


If the filename specified in the message is ACCTS.TOT or ACCTS.RPT, a 
write error has occurred. Some data will be missing from the file. 
Data can be retrieved by comparing the ACCTS.TOT file with ACCTS.RPT 
unless both files are reporting problems. 


If errors persist, print or dump all files under [1,5] to retrieve 
data and locate the problem. 
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2.4.3 ACCOFF Error Messages 


ACCOFF -- PLEASE RUN ACCRPT TO PRESERVE DATA 

The request from ACCOFF to run ACCRPT failed; probably ACCRPT was not 
installed. ACCOFF does not terminate accounting until all data is 
preserved. Type the following commands. 


INS [11,1]ACCRPT 
RUN ACCRPT 


ACCOFF -- ABORT FAILED; ABORT ACCLOG FROM CONSOLE 


For some reason ACCOFF was unable to abort ACCLOG. Use the ABO command 
to terminate ACCLOG, as follows. 


ABO ACCLOG 


2.4.4 ACCABT Error Message 
ACCABT ~~ ABORT FAILED; ABORT ACCLOG FROM CONSOLE 


For some reason ACCABT was unable to abort ACCLOG. Use the ABO command 
to terminate ACCLOG, as follows. 


ABO ACCLOG 


2.5 ACCOUNTABLE TASKS AND SAVING THE SYSTEM 


The SAVE command (see the RSX-11D User’s Guide, Section 6.23) 
preserves on disk a copy of the memory part of an RSX-11D system. The 
disk can thereafter be bootstrapped to restart the system. 


A SAVE may be performed only when the system is guiescent, as defined 
in the section referred to. This includes, for example, no loading of 
tasks or peripheral transfers in progress. However, an accountable 
task can be resident and if a SAVE is performed, the time limit will 
be recorded and, on the disk being bootstrapped, will continue from 
where it was before the save. This can result in terminations for 
time limit for tasks that seem not to have run for very long. 
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CHAPTER 3 


SPOOLING, DESPOOLING AND INPUT SPOOLING 


RSX-11D provides three types of file spooling: 
1. Automatic output spooling to disk, 
2. Automatic despooling of disk files queued for printing, 
3. Input spooling from a card reader to disk. 


Automatic output spooling eliminates program contention for line 
printers, teleprinters, and other serial output devices. Because 
programs do not have to wait to use a serial device, higher system 
throughput is achieved. 


The need to wait for a particular device is removed by temporarily 
redirecting the output intended for the serial device to a disk file. 
This temporary redirection is defined as automatic output spooling. 
The files redirected to the disk are later produced on the original 
device. This process is defined as despooling. 


RSX-11D provides several levels of automatic output 
spooling/despooling. On the simplest level, the automatic output 
spooler can queue files for the single device despooler which prints 
them one at a time on a first-in/first-out basis. Only one output 
device is used at a time. 


On a more sophisticated level, the automatic output spooler and the 
console user both can queue files for printing. In this case, the 
multiple device despooler is used. It sends queued files for printing 
on a priority basis. Up to 26 devices can be used for despooled 
output simultaneously. 


The input ‘spooler eliminates program contention for the card reader 
and serves as a batch job input device. Card files are read onto a 
disk and placed under a user-specified UFD. 


3.1 AUTOMATIC OUTPUT SPOOLING 


Automatic output spooling is implemented for use with programs using 
RSX-11D FCS. It is not operational with programs using the QIO 
directive. However, both automatic output spooling and programs 
issuing QIO directives can coexist when using the same output device. 
The program uSing QIO directives should adhere to the following 
procedure: 


1. Attach the output device, 


2. Space the form to headmof-form if using a line printer, 
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3. Issue the QIO directives, 
4. Detach the output device. 


If the task issuing the QIO directives is executing under a privileged 
UIC of [l,n], it must interrogate the status returned from the attach 
QIO tio ascertain whether the device already is attached. If the 
device already is attached, the calling task should wait for a 
significant event and then retry the attach. 


3.1.1 System Reguirements for Automatic Output Spooling 


The following three system requirements must be met for automatic 
output spooling. 


1. The SY device must have a UFD of [1,4] with read, write, 
extend and delete privileges for owner, group, system, and 
world. The following command is used to put the UIC on SY. 


MCR>UFD SY: [1,4] /PRO=[RWED,RWED,RWED,RWED] 


2. A PUD for SP (spooler) must be created .during system 
generation. A DEV directive to create a PUD for SP is 
included in the system generation command files’ on the 
distribution medium. The command has the following format. 


DEV=SP 


3. The SP PUD is normally assigned to SY during Phase 2 of 
system generation by the redirect.command: 


MCR>RED SY=SP 


Once the above command has been issued, the system manager 
has the option of redirecting the SP PUD to any disk device. 
Redirection can be performed at any time. The device that SP 
is assigned or redirected to must have a UFD of [1,4] with 
the same protection as defined above. 


4. Both the devices assigned to SY and SP must be write enabled. 


3.1.2 Program Conventions For Automatic Output Spooling 


The following requirements must be met by the MACRO-11_ program 
producing the file to be spooled. 


1. The file storage region must contain at least a 512-byte 
output area to contain the output for the file that is 
targeted for the serial device. It is allocated using the 
FSRSZ$ macro. An open failure results on the output file if 
less than 512 bytes are supplied. 


2. The program must open and close the output file. 

3. An open by file identification or an open by filename block 
must be preceded by a call to .PARSE or by obtaining the 
directory identification. 


4. The program must not attempt to regain access to the file 
once it is closed. 
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5. The maximum output record size must not exceed 256 bytes. 


The FORTRAN compiler automatically adheres to the above procedures 
within the FORTRAN OTS. However, FORTRAN programs using the DEFINE 
FILE statement, must ensure that the maximum output record size of 256 
bytes is not exceeded. 


3.1.3 Enabling or Disabling Automatic Output Spooling 

Automatic output spooling is enabled or disabled on an output device 
by typing the SET command to MCR. The syntax of the SET command. to 
enable spooling follows with brackets indicating optionality. 


MCR>SET /SP=dev:[,dev:,...,dev:] 


/SP= is the command switch for automatic output spooling. 

dev: indicates which device(s) are to have files spooled. 
dev is a 2-character device name and a l- or 2-digit 
unit number. The device must be both a 


carriage-controlled and a record-oriented device, e.g., 
line printer or teleprinter. 


Any attempt to set spooling of files for a device that is not a 
teleprinter or a line printer results in the printing of the following 
error message on the console. 

SET -- SPOOLING NOT SUPPORTED IN THIS RELEASE FOR THIS DEVICE 
The syntax of the SET command to disable spooling follows. 


MCR>SET /-SP=dev: [,dev:,...,dev:] 


/-SP= is the command switch to disable spooling. 
dev: indicates those devices whose files are no longer to be 
spooled. 


The SET command can be used at any time to enable or disable spooling. 
The SYS /DEV command can be typed to MCR to determine whether spooling 
is enabled or disabled for a particular device. Any device for which 
spooling is enabled is designated as follows. 


dev: SPOOLED x 


x is the designated form type for the device. Refer to 
Section 3.2.1.5. 


3.1.4 Automatic Output Spooling Technigue 


The RSX-11D system performs special functions for programs writing 
spooled files when the file is opened, as individual records are 
written, and when the file is closed. 


During open, when the output LUN is assigned to the file, the system 
determines whether the output device is spooled. If it is, the output 
device is redirected to SP. Normally, a file is created in UFD [1,4] 
with a 2-character filename indicating the final output device and a 
file type of .SPR. The file specification has the following format. 
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SP: [1,4] dv.SPR:n 


dv is the device on which the file is to be printed, e.g., 
LP. 

n is the file version. It is one greater than any 
current file having the same filename and file type in 
UFD [1,4]. 


FORTRAN programs differ in that they have the following file 
specification. 


SP: [uic] FORnnn.DAT;n 


uic is the terminal user’s UIC. 
nnn corresponds to the logical unit number used to create 
the file. 


During program execution, each successive PUTS results in placing the 
contents of the output buffer into the 5l2—byte block. When the _ file 
storage region block is filled, its contents are written into the file 
space on the disk. 


When the file is closed, the file identification information is taken 


from the file description block (FDB) and sent to the despooler task 
using a SEND/REQUEST DIRECTIVE. 


3.2 DESPOOLING 
RSX-11D provides two despooling functions: 
1. Single device despooler, 


2. Multiple device despooler. 


NOTE 


The Multiple device despooler must _ be 
used if BATCH is to be run. 


The single device despooler services SEND/RECEIVE requests on a 
first-in/first-out (FIFO) basis. The single device despooler is 
intended for smaller systems not requiring a system manager ’s operator 
interface by means of the OPR command to MCR or a terminal interface 
command by means of the QUE command to MCR. 


The single device despooler has a file name of [11,1]PRT and a task 
name Of SPR... . 


The multiple device despooler can service up to 26 devices 
Simultaneously. It consists of four tasks as listed in Table 3-l. 
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Table 3-1 
Multiple Device Despooler Tasks 


FUNCTIONS TASK NAME 


System manager ‘s operator .--OPR 
interface to despooling 


FILE NAME 


[11,1]OPR 


[11,1] QUE User ’s console interface .- QUE 


[11,1]SPR Despooler queue manager SPR... 


[11,11]SPR2 Multiple device despooler SPR2.. 


3.2.1 Multiple Device Despooler Options 


The multiple device despooler has the following options that are not 
available with the single device despooler: 


1. QUE and OPR commands to provide user and system manager 
interface with despooling, 


2. Up to 26 output devices, 

3. Despooling of any file on a Files-1l directory device. 

4. Output by priority, 

5. Multiple form types, 

6. Capability to obtain multiple copies of a file, 

7. Capability to delete or preserve the file after printing, 


8. Batch output support. 


3.2.1.1 QUE and OPR Commands to MCR - The QUE command provides the 
user with a terminal interface with despooling. The QUE . command 
allows the user to perform the following: 


1. Queue files to be despooled for printing on any teleprinter 
or printer, 


2. List files that are queued for despooling, 
3. Delete (kill) entries from the queue, 


4. Modify entries in the queue. The following options can be 
modified for an entry: 


a. The output device to be used for printing, 
b. Priority of the entry, 

c. Form type to be used, 

ad. Number of copies to be printed, 


e. Whether the file is to be deleted or preserved after 
printing. 
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The despooler handles all files identically regardless of whether they 
were queued by the automatic output spooler or the QUE command. 


The OPR command is the system manager’s interface with despooling. It 
allows the system manager to perform the following: 


1. Stop output, 
2. Resume output, 
3. Resume output from the beginning of the input file, 


4. Resume output from the last top-of-page encountered in the 
input file, 


5. Abort output, 
6. Begin despooling output, 
7. Change the form type, 


8. Indicate that a form type change is to occur and set up the 
printing of files to test form type alignment, 


9. Recycle all devices that were being used for despooling prior 
to a system crash. This option provides a recovery of 
despooling operations. 


The QUE and OPR commands are detailed in the RSX-11D User’s Guide. 


3.2.1.2 Multiple Output Devices - Files can be despooled to up to 28 
output devices simultaneously. Any printer or teleprinter can be 
specified as the output device. The output device does not have to be 
specified for spooling in an MCR SET command. Setting a device for 
spooling only affects automatic output spooling; it has no effect on 
the despooling operation. That is, a device does not have to be 
spooled to have files queued to it for despooling. 


3.2.1.3 Despooling of any File - Any file on a Files-1l directory 
device can be designated in a QUE command for despooling. The file to 
be printed should be other than a binary file, such as a data, source, 
list, or map file. 


An attempt to print a binary file such as an object or task-image file 
results in a despooler error and an automatic abort of despooling 
operations for the file. 


3.2.1.4 Despooling Priority - Priority determines the order in which 
files are despooled. The priority can be specified in the QUE command 
or the PRINTS macro or it can default to the task’s running priority. 
Priority is a decimal number in the range of 1 through 259. 


3.2.1.5 Multiple Form Types — The type of form on which the file is 
to be printed can be specified by a number in the range of one through 
seven. The form type value itself is contained in the PUD for the 
device and can be displayed using the SYS /DEV command. The system is 
generated with a form type of @ for every printer and teleprinter. 
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The PUD form type value can be changed dynamically by the systen. 
Manager uSing the OPR command. Two Switches to the OPR command are 
provided for this purpose. 


1. /CHG alters the form type of the specified device to form 
type 7. Form type-7 is reserved for the despooling of test 
files to verify the form alignment. Test files can be queued 
by using the /TE option of the QUE command. 


2. /FO:n alters the PUD form type to the value n; n is in the 
range from @ through 6. 


The system manager determines which form types correspond to the 
numbers zero through six. The OPR command is used to specify the 
value for the current form type for a particular device by placing 
that value in the PUD. 


The system manager can assign separate values for different form types 
or have several form type values correspond to the same type of 
printer paper. However, the following facts should be considered. 


1. Files queued to be printed on a particular device with a 
specified form type are printed only when the PUD for that 
device has a matching form type value. 


2. Form type @ is the form type initially contained in the PUD 
for each printer or teleprinter; therefore, it is logical to 
define the most commonly-used printer form as form type @. 


3. Despooling of queued files onto a device with a matching form 
type is automatic. Differing form types require the system 
manager to alter the PUD form type using the OPR command. 


3.2.1.6 Multiple Copies of the Printed File - The user can_ specify 


the number of copies of a file that are to be printed. The number of 
copies is a decimal number in the range of 1 through 31. 


3.2.1.7 Delete/Preserve Indicator - The user can specify whether’ the 
file is to be deleted after printing or to be preserved for subsequent 
use. 


3.2.1.8 Account Number - The account number is the UIC of the user 
who queued the despool request. The account number determines access 
rights of a nonprivileged user to modify or delete a queued request. 
It also determines which entries are to be listed in response to a 
Queue List MCR command. 


3.2.2 Functions of the Despooler Tasks 
QUE, OPR, SPR, and SPR2 are the four tasks used to achieve multiple 


device despooling. The functions of QUE and OPR are presented in 
Section 3.2.1.1. SPR and SPR2 are described below. 


3.2.2.1 SPR (Queue Manager) - SPR is the queue manager. It receives 
SEND/REQUEST directives that are directed to the multiple device 


Ba 


SPOOLING, DESPOOLING AND INPUT SPOOLING 


despooler and creates an entry in the queue. The despooler queue is a 
file that is maintained on the system disk under UFD [1,4]. The file 
is created by the gueue manager should no file exist. The file 
specification for the queue follows. 


SY: [1,4] SPRQUEUE.SYS 


SPRQUEUE.SYS is a dynamically expanding file capable of holding up to 
2047 (decimal) queued items. The queue manager selects files (queue 
entries) to be despooled based on the number of devices the multiple 
device despooler can service simultaneously. It issues a SEND/REQUEST 
directive to the multiple device despooler. The queue manager is 
active only when it is queuing an entry or engaged in sending a new 
file specification to the multiple device despooler. 


The selection algorithm for determining which entry to send to the 
multiple device despooler is illustrated in Figure 3-l. 


3.2.2.2 SPR2 (Multiple Device Despooler) - SPR2 is the multiple 


device despooler task. It writes the files indicated to it by SPR on 
the designated printer or teleprinter. SPR2 is AST-driven and handles 
up to 26 devices simultaneously depending on the size of the task when 
installed. 


SPR2 supports one device automatically. For each additional device to 
be supported, another 468 words must be added to the size of SPR2 when 
it is installed. The /INC switch is used in the INS command to MCR to 
increase the task size. Multiply the number of devices’ to be 
supported by 4698 to determine the appropriate value to use in the /INC 
switch. For example, if three devices are to be supported, type the 
following command when SPR2 is installed. 


MCR>INS [11,1]SPR2/INC=1389 (3 * 460 = 1386) 


3.2.3 Interfaces to the Despooling Tasks 


RSX-11D provides four interfaces with the despooling tasks: 


1. Automatic output spooling triggered by the closing of a_ file 
that is assigned to a spooled device, 


2. The PRINTS macro call, 
3. The QUE command to MCR, 
4. The OPR command to MCR. 


Automatic output spooling is operational for both the single and 
multiple device despoolers. 


3.2.3.1 Print$ Macro Call - The PRINT$ macro call is the _ program 
interface with the despooler. It is operational with both the single 
and multiple device despooler. The syntax of the PRINTS macro is 
described in the IAS/RSX-11 I/O Operations Reference Manual. 
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CAN 
SPR2... 


DEVICE 
2 


SELECT HIGHEST 
PRIORITY QUEUED 
ITEM. 


URRENTLY DE- 
SPOOLING ON 


FIND THE NEXT 
QUEUED ITEM 


ISSUE THE 
SEND/REQUEST 
DIRECTIVE 


Figure 3-1 Queue Entry Selection Algorithm 
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The multiple device despooler is capable of using more of the 
parameters passed to it by PRINTS than the single device despooler 
can. Table 3-2 summarizes the differences. 


. Table 3-2 
PRINTS Capabilities of the Single and Multiple Device Despoolers 


PARAMETER SINGLE DEVICE | MULTIPLE DEVICE 


Output device yes 
Input filename yes 


Priority yes 

Form type yes 

Number of copies 1 through 31 
Delete/preserve the file|delete either 


If parameters that do not apply for the single device despooler are 
included in a PRINTS macro call to that despooler, they are ignored. 


3.2.3.2 QUE and OPR Commands - The QUE and OPR commands to MCR are 
the user’s and system manager s terminal interface to the despooling 
tasks. Both commands are summarized in Section 3.2.1.1. 


This interface is operational only for the multiple device despooler. 
The system manager should install these tasks only if the multiple 
Gevice despooler is installed. 


3.2.4 Priorities of the Despooling Task 


All of the despooler tasks run in the GEN partition with a priority of 
108. If the system manager wishes to change their priorities, he 
should consider the following paragraphs. 


3.2.4.1 OPR - The priority of OPR should be maintained at a high 
value. The task must be able to communicate instantaneously with SPR2 
(multiple device despooler). 


3.2.4.2 QUE - The QUE task is a multiuser task. Its running priority 
is not critical and can be altered to any value. However, ideally, 
its priority should not exceed that of the gueue manager (SPR). 
Multiple SEND/REQUEST directives to SPR, such as a number of modify or 
kill QUE commands could cause the pool limit of 198 to be exceeded. 


3.2.4.3 SPR (Queue Manager) - The queue manager should operate at a 
priority of 19@. It should process SEND/REQUEST orders in a reasonably 
short time. SEND/REQUEST orders originate from any task desiring a 
despooling operation, e.g., MACRO-l1l, FORTRAN, and the task builder. 


It is not recommended that SPR’s priority be increased x2bove 190 
because the efficiency increases proportionally to the number of 
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SEND/REQUEST orders queued. Under these conditions, the gueue manager 
performs a minimum number of read operations or write operations of 
the queued file. 


3.2.4.4 SPR2 (Multiple Device Despooler) - The multiple Gevice 


despooler can operate at any priority from 1 through 248. The system 
manager should determine the optimum priority for his’ system. The 
following points should be considered. 


1. The number of queued input files increases if the despooler 
task is not able to despool files at the same rate that’ they 
are queued. An increase in the number of files queued 
Slightly reduces the performance of the queue manager. 


2. If the system manager desires more work performed by other 
processes than the despooler, the despooler can be lowered to 
a priority that is less than the priority of the other 
processes. 


3. If it is desirable to expedite the output of certain files, 
the priority of the despooler can be altered dynamically 
using the MCR Alter Priority command. The change in priority 
should be lowered after the file has been despooled. 


4. The multiple device despooler should not have a priority 
greater than 219. A priority greater than 218 may cause the 
despooler to interfere with device handler or FIJ1ACP task 
execution. 


3.2.5 Error Recovery Procedures 
Error recovery procedures for device or file errors, internal 


despooler errors, and queue manager errors are described in the 
following paragraphs. 


3.2.5.1 Device or File Errors - The following procedures should be 
used if persistent errors occur on a given device. 


1. Execute the MCR OPR command to change the form type for’ the 
device. 


MCR>OPR dev:/CHG 


2. Abort the file being processed on the device receiving 
errors. 


MCR>OPR dev: /AB 


3. Perform a redirect of the device to an alternate device, if 
appropriate. 


4. Once the redirect has been performed or the device has been 
repaired, reset the form type to its original value. 


MCR>OPR dev:/FO:n 


3.2.5.2 Internal Despooler Errors (Task SPR2..) - The following 


procedures should be used if an internal error occurs in the despooler 
task. 
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1. Obtain a list of all queued files. 
MCR>QUE/AL 


2. Repeat the MCR OPR change of form type command for all output 
devices in the queue. 


MCR>OPR dev:/CHG 
3. Abort the despooler task. 
MCR>ABO SPR2.../TI=TT@: 


4. Perform an MCR OPR recycle command to make all active orders 
inactive. The /RE switch is used to recycle. 


5. Reset all changed forms to their original value. 


3.2.5.3 Queue Manager Errors (Task SPR...) - If persistent gqueue 
Manager errors Such as read/write errors on the queue file occur or if 
the queue manager enters a loop, the following error’ recovery 
procedures should be used. 


l. Abort the queue manager if it is active. 
MCR>ABO SPR.../TI=TTS@: 


2. If possible, dump the gueue file. Use the following commands 
to disable spooling for the line printer and to dump _ the 
file. 


MCR>SET /-SP=LP: 
MCR>DMP LP:=[1,4]SPRQUEUE.SYS 


3. Delete the queue file ([1,4]SPRQUEUE). 


4. Obtain a directory of [1,4] and if it contains any files of 
type .SPR requeue these files using the following command. 


MCR>QUE [1,4]*.SPR;*/DE 
5. Enable spooling for the line printer, if it was disabled. 


MCR>SET /SP=LP: 


3.3 INPUT SPOOLING 


RSX-11D provides an input spooling task called [11,1]SPL. Once 
installed, the task can be called by any task issuing a SEND DATA AND 
RESUME OR REQUEST directive. Th input spooler is a multiuser’ task 
that can be called simultaneously by more than one task. The task 
reads variable length data from an input device. 


To call the input spooler, data sent to the input spooler should have 
the following format: the first word contains the 2-character ASCII 
device name and the second word contains the unit number in binary of 
the input device. 
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Once the input spooler task is called by the send directive, it 
receives the same TI as the TI assignment of the task issuing the 
directive. When invoking several simultaneous versions of the input 
spooler task, the user should ensure that the tasks issuing the 
send/request directives have different TI assignments. 


The input spooler reads double-buffered, variable-length input data. 
The data can have a maximum length of eighty characters. 


All RSX-11D card reader handlers (CRBR and CRNP) automatically call 
the input spooler if input spooling is enabled on the card reader 
device. 


During the input spooling of card decks, files are spooled directly 
into the user’s UFD which must be specified on the S$CREATE card. For 
input spooling of BATCH job files the same system requirements must be 
met as for output spooling (see Section 3.1.1). 


3.3.1 Enabling and Disabling Input Spooling 


Input spooling is enabled and disabled using the SET command to MCR. 
Use the following command to enable spooling. 


MCR>SET /SP=CRn: 
Use the following command to disable spooling. 
MCR>SET /-SP=CRn: 


The DEV command can be issued to MCR to determine whether a card 
reader is spooled or not. If it is spooled, it has the word SPOOLED 
printed with the card reader status. 


3.3.2 Basic Operations 


When files are to be spooled from the card reader, set the device as 
being spooled, place a deck in the card reader input hopper and 
depress the READY switch. This action causes the card reader handler 
to request the input spooler task (SPL...). If the input spooler is 
not installed, the following message is printed on the terminal. 


***CRn SPL TASK NOT INSTALLED 


The console operator should install the input spooler; operation 
resumes automatically with a maximum delay of one minute. 


Once the input spooler is loaded, it reads cards until no more remain 
in the card reader input hopper. 


3.3.3 Format of the Input Deck 


Input decks consist of one or more data decks. Each data deck must be 
peceded by a header card and followed by an EOF card. The CREATE card 
is the data deck header. It is followed by the actual data cards and 
an EOF card as illustrated in Figure 3-2. The formats of the header 
and EOF cards are described below. 
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CREATE filespecification/switches 


Gata cards 


EOF card 


Figure 3-2 Format of Input Data Deck 


3.3.3.1 Format of the CREATE Card (Data Deck Header) - The CREATE 
card has the following format. 


col 1 
CREATE dev: [ufd] filename.type;version/switches 


CREATE must appear in columns 1 through 6. The file specification is 
the standard RSX-11D file specifier. Table 3-3 lists default fields 
in the file specifier. Table 3-4 lists and defines the switches’ that 
can be used on the CREATE card. 


Table 3-3 
Defaults in CREATE File Specifier 


FIELD DEFINITIONS DEFAULT 


The device onto which the file is to 
be spooled. It must be a directoried 
disk device. 


A valid UFD that is defined on dev:. No default. 
Must be 
specified. 


filename Name to be used for the file spooled No default. 
onto the disk. Must be 
specified. 


File type DAT 


File version can be specified If /-NV, ver is 

or omitted. 1. If /NV, ver 
is one greater 
than the exist- 
ing version 
number. 
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Table 3-4 
CREATE Card Switches 


SWITCH DEFINITION DEFAULT 


Suppress all trailing blanks 
Do not suppress trailing blanks 


Delete card columns 73 through 88 
(Sequence number) 
Do not delete columns 73 through 89 


Create a version number that is one 
greater than the existing version of 
the file. 

Do not create a version number that is 
one greater than the existing version 
of the file. 


The input spooler first searches the UFD on the indicated device to 
determine whether the specified file already exists. If the file 
exists, a new file is not created unless the /NV switch has’ been 
specified. If /NV is not specified, the following message is printed 
on the terminal. 


SPL -—- FILE ALREADY EXISTS 
This message is followed by a printout of the header card. 
If there are no errors in the file specification, the data cards up to 
but not including, the EOF card are written onto the disk. 
NOTE 


Neither the CREATE card nor the EOF card 
is written in the file. 


3.3.3.2 Format of the EOF Card - The EOF card contains a 12, 11, @, 
1, 6, 7, 8, 9 multipunch in card column l. 


3.3.4 ‘Input Spooling Support of BATCH 


In addition to processing CREATE cards, the input spooler processes 
standard RSX-11D batch job control cards. A $JOB card either as_ the 
first card in the card reader input hopper or following an EOF card is 
treated in the same manner as the CREATE card. 
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3.3.4.1 $JOB card - The format of the $JOB card is identical to the 
$JOB card described in the RSX-11D Batch Reference Manual. The user 
should use the /ACCOUNT switch to establish the proper UIC for 
accounting. The batch file is spooled onto the physical device to 
which SP is directed, under UFD [1,4]. If the /NAM switch is included, 
the specified job name becomes the name of the file on disk. In the 
following example, the file is named BJOB12. The file type defaults to 
-BIS. 


$JOB/NAM=BJ0B12/LIM=2098 


If the /NAM switch is not included, the default filename is RSX11DBAT, 
which also is the default batch job name. 


3.3.4.2 Processing of Spooled Batch Input - The $JOB card causes a 
file to be created on disk. The disk file contains the SJOB card 
followed by data cards, followed by the SEOJ card. 


The input spooler closes the output file once it reads the $EOJ card. 
To combine several jobs’ in one disk file, the user should omit the 
SEOJ card from each separate’ job and terminate only the last job with 
a $EOJ card. 


3.3.4.3 Automatic Calling of Batch - Provided the SEOJ card is 
followed by two successive EOF cards (3.3.3.2), the input spooler 
closes the spooled file on disk, then issues a SEND/REQUEST directive 
to batch (...BAT). If ...BAT is installed, it automatically starts 
processing the file. The input file created by the input spooler is 
Geleted automatically by batch after it processes the input data. If 
it is not installed, the operator receives no notification. This 
approach permits batch job files to be created with or without 
automatic calling of batch. 


3.3.5 End of Input Spooling 


When the input spooler reads two successive EOF cards, it prints the 
following message on the operator’s terminal. 


SPL -- END OF SPOOL INPUT 


If the two successive end cards are followed by an input hopber’ empty 
condition, the card reader handler enters a waiting state and the 
input spooler exits. If the input hopper is not empty and spooling is 
still requested for files, the card reader begins reading cards. 
Input decks can be placed one behind the other in the input hopper or 
the hopper can be allowed to empty before a new deck is placed in the 
hopper. Pressing the RESET button again resumes input spooling. 
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3.3.6 Disk Files Created by Input Spooler 


With the exception of batch files, the disk files created by the input 
spooler are not deleted by it. The files must be deleted under user 
control. The files cannot be accessed using’ the CR: input 
designator; they must be accessed using the full input file 
specification. This specification is identical to the file 
specification supplied on the CREATE card or to the SJOB default 
specification, as described in Section 3.3.4.1. 


3.3.7 Aborting a Batch Job 


Ordinarily batch jobs should not be aborted. However, if it becomes 
necessary to abort a batch job, use the following procedure. 


1. Abort the task BPR. 
AB@® BPR.../TI=BPd 

2. Obtain an active task list. 
ACT /ALL 

3. Abort any task that has a TI designation of BPO. 

4. Delete all batch files created for the execution of the 
aborted batch job. If only one batch job is queued or 
executing under the UFD that contained the batch job, the 
files should be deleted using the command: 

PIP RSX11DBAT.*,*/DE 
If more than one batch job is gueued for the particular UFD, 
wait until the queued batch jobs complete and then deleted 
the files using the PIP command described above. 

5. Set the invoking terminal to a nonspooled state. 


SET /-SP=TTn: 


6. Rerun the task BPR... to resume processing of other batch 
jobs within the queue. 


RUN BPR... 


7. The partial listing output from the aborted batch job is 
printed at the completion of the next batch job. 
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CHECKPOINTING 


Checkpointing is a mechanism to aid high priority tasks obtain the 
memory required to execute as soon as possible after they are 
requested. The process provides for temporarily halting the execution 
of one or more tasks in an orderly fashion to free memory for 
execution of a higher priority task. A task image of each halted task 
is rolled onto disk to free memory for the higher priority task. 
Checkpointing also is known as rollout/rollin. 


Individual tasks can be built at task build time as checkpointable or 
non-checkpointable (see the RSX-11D Task Builder Reference Manual). 
The checkpointability of a task can be disabled/enabled using the 
directives described in the RSX-11D Executive Reference Manual. 


Two factors are critical to the operation of checkpointing: 


1. Whether any executing tasks have been designated as 
checkpointable during task building. 


2. The priority of tasks that require memory for execution. 


To control these factors, the Executive maintains information about 
which tasks can be checkpointed and maintains the memory required list 
(MRL) of tasks waiting for execution. Checkpointable task list (CTL) 
information is threaded through two system tables: the active task 
list (ATL) and the memory required list (MRL). The layout of the ATL 
and MRL is provided in Appendix A of the RSX-11D Executive Reference 
Manual. 


4.1 CHECKPOINTABLE TASK LIST (CTL) 


Every system-controlled partition has an associated checkpointable 
task list (CTL). Each CTL is ae priority-ordered list of all 
checkpointable tasks that are active in or queued to run in the 
partition. All tasks are checkpointable unless specified as not 
checkpointable (/-CP) during task building. CTL is scanned in reverse. 
order to ensure that the lowest priority tasks are the first 
candidates for checkpointing. 


4.2 MEMORY REQUIRED LIST (MRL) 


The memory reguired list (MRL) is a priority~ordered list of tasks 
that are waiting for memory to become available in a partition. There 
is one MRL for each partition. If more than one task is in the MRL, 
lower priority tasks are not considered for execution until the 
highest priority task starts execution. 
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4.3 FUNCTIONAL DESCRIPTION 


When a task is listed in the MRL, the following series of events 


occurs. 


Ls 


A routine scans the CTL to determine whether a checkpointable 
task with a priority lower than the task awaiting memory is 
executing. The scan occurs wjenever a task is inserted or 
reinserted in the MRL. 


If a checkpointable task is running, a routine allocates a 
checkpoint image for the task on disk and, if successful, 
performs either of the following: 


a. If the task has no I/O in progress, calls the rollout 
routine. 


b. If the task has I/O in progress, marks the task for 
checkpointing. When a task is marked for checkpointing, 
no I/O requests are dequeued for it. When the I/O in 
progress is completed, the I/O done function calls’ the 
rollout routine. 


The rollout routine initiates the actual rolling out of the 
task image and sets its status to suspended for 
checkpointing. 


The task remains in the ATL until it is recorded on the disk. 


Another routine relinks the task’s ATL node to the MRL at the 
tasks original priority. 


after the rolled out task’s memory is freed, an attempt is 
made to activate the task that forced checkpointing. If this 
routine fails to find sufficient memory, it calls the routine 
in step 1 to try to roll out another checkpointable task. 


when a checkpointed task returns to memory, the appropriate 
handlers are restarted, ASTs are restarted, and the disk area 
used for the task image is released. 


NOTE 


When the checkpointed task resumes 
execution, it does not necessarily 
occupy the same memory area in which it 
was executing; i.e., any available 
memory area of sufficient size in the 
same partition can be used. 
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GLOBAL LIBRARIES AND COMMON AREAS 


RSX-11D provides a means of using and maintaining global libraries and 
common areas. Global libraries are collections of routines that can 
be shared by many Simultaneously active tasks. Global common. areas 
are data areaS in memory that can be shared by many simultaneously 
active tasks. 


In fact, global libraries and common areas are the same type of 
entity. Both are treated similarly by the system. The only real 
difference is in terminology to aid the user in understanding their 
functions. For this reason, global libraries and common areas are 
referred to as shared global areas (SGAsS). SGAS are completely 
dynamic; without requiring a system generation. Each task can use a 
maximum of seven SGAs. 


5.1 PURPOSE AND USE OF SGAs 


The purpose of a shared global area (SGA) is to allow the system 
designer to share code and data among simultaneously active tasks. 
For example, the FORTRAN compiler and the editor share the SGA 
(library) named SYSRES when they are both active at the same time. 
Similarly, two or more FORTRAN programs can exchange data through an 
SGA (common area). 


An SGA is loaded into real memory whenever a task that links to it is 
requested for execution. However, if the SGA already has been loaded 
into memory by a= previous task execution, the in-memory version is 
used; duplicate copies of SGAS never occur. 


An access count is maintained for each SGA. An SGA remains in memory 
as long as the count is greater than zero. When a task exits or is 
checkpointed to the disk, the access count for any SGAsS that the task 
refers to is decreased by one. If the count becomes zero, the memory 
allocated to the SGA is’ released. In addition, if the SGA was 
installed in the system as a read/write, as often is the case with 
common areas, the SGA is written to the disk when the access count 
becomes zero. 


NOTE 


SGAs are not checkpointable and never 
are checkpointed. However, read/write 
SGAS are written back onto the disk over 
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the original file when their access 
count becomes zero. 


Read-only SGAs simply have their memory 
released when the access count becomes 
zero. 


The access count becomes zero if, for 


example, all tasks linked to the SGA are 
checkpointed. 


The read-only (pure) area of multiuser tasks is treated in exactly the 
same manner as the read-only SGAs. The only difference is that the 
SGA is global to many tesks (i.e., referred to by name) and the pure 
area of a task is local to the task with which it was built. 
Multiuser task read-only areas are created, installed, loaded, and 
removed, automatically by the system. 


5.2 IMPLEMENTATION OF SGAs 


An SGA is contructed and introduced to the system in three distinct 
phases, namely: 


writing the SGA, 
Task building, 


Installation and removal. 


5.2.1 Writing the SGA 


Because SGAS are used to perform a variety of functions, the following 
generalizations should be considered when writing an SGA. 


1. Read-only libraries of routines must be written in MACRO-11 


assembly language. The user is responsible for alli 
re-entrancy problems. The user must write his own re-entrant 
code. 


2. Read/write areas can be written in MACRO-1l language or as 
FORTRAN block data subprograms. Re-entry problems do not 
exist for read/write SGAs. 


If the SGA is written as a FORTRAN block data subprogram, it 
is recommended that the data be initialized by the DATA 
statement. 


3. The user is responsible for synchronization of accesses to 
the data base in read/write areas. 
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5.2.2 Task Building the SGA 


The RSX-11D Task Builder Reference Manual contains a complete 
descriotion of the task builder and its options. The following 
descriptions are intended to provide an outline of the procedure for 
and the main points of task building an SGA. 


First, the uSer is responsible for determining whether an SGA is 
position independent. Refer to the IAS/RSX-11 .MACRO-1ll Reference 
Manual for a discussion of position independent code. Position 
independency indicates the ability of a bound module (either code or 
data area) to exist anywhere in the virtual address space of a task. 
All FORTRAN block data subprograms must be built as being position 
incGependent; they are so by definition. 


Secondly, the SGA must be task built. The user must be operating 
under UIC [1,1] when TKB is requested. The output from the task build 
operation is the following: 


1. A task image of the SGA under UFD [1,1], 
2. A symbol table file under UFD [1,1], 
3. Optionally, a map file. 

The following task builder input is mandatory: 


1. Tne no header switch (/-HD) must be used on the task image 
outout file, 


2. The input options STACK=@8 and UNITS=@ must be specified. 


If the SGA is position independent, the /PI switch can be _ specified. 
The /PI switch must be included on FORTRAN block data SGAs. 


5.3 INSTALLATION AND REMOVAL OF AN SGA 


SGAs are installed into the system and removed from it in a manner 
similar to task installetion. The system MCR functions INS and REM 
are used. See the RSX-11D User’s Guide for a complete description of 
these functions and their options. Below is a description of the main 
points of the installation and removal process. 


1. At installation, the user specifies that the file being 
installed is an SGA by uSing either the /LI_ switch to 
indicete that the file is a global library or the /CM switch 
to indicate that it is a common area. INSTALL determines 
that the entity is an SGA and assumes that the SGA is a 
common erea unless /LI is specified. 


2. The owner UIC is specified at installation by means of the 
/uIc=[n,n] switch. The owner UIC always should be specified 
when the SGA is installed. 


3. The nonowner protection that is applied to the SGA is 
specified at installation by means of the /ACC= switch. The 
switch can be specified in the form /ACC=RO for read-only or 
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/ACC=RW for read/write. The default is no access; be sure 
to include the switch if tasks running under a nonowner’ UIC 
are to have access to the SGA. 


5.3.1 Effect of Installaticn 


Within the system, the main effect of installing an SGA is to create a 
global common directory (GCD) entry. The GCD entry is a control block 
that serves to identify the SGA to the system. Refer to the RSX-110 
Executive Reference Manual for the formet of a GCD entry. One 
important field in each GCD entry is the installed reference count. 


5.3.1.1 Installed Reference Count - The system uses the installed 
reference count to keep track of the number of tasks that currently 
are installed and that refer to the SGA. 


NOTE 


Do not confuse the installed reference 
count with the active task access count. 


An SGA must be installed prior to installation of the tasks that link 
£6: Le. 


The maximum number of tasks that can refer to one SGA is 255 
(decimal). This count is set to zero when the SGA is installed. The 
count is increased by one whenever a task that links to that SGA is 
installed. 


Similarly, whenever a task that links to the SGA is removed, the count 
is decreased. Therefore, if an attempt is mace to remove an SGA using 
the REM command to MCR, the installed reference count is checked. ‘The 
removal is not allowed if the count is nonzero, i.e., if instelled 
tasks refer to that SGA. Before an SGA can be removed, all tasks that 
link to it must be removed. 


5.4 SGA OPERATION AT RUN TIME 


Once the SGA is installed in the system and a GCD entry exists, it can 
be loaded into memory for use by tasks that refer to it. A brief 
description of the basic mechanism for loading and unloading SGAs 
follows. 


5.4.1 Access Count in the GCD 


At run time, the most important field of the GCDB entry is the eccess 
count. This count is increased whenever a task that links to the SGA 
is loaded successfully into memory. It is decreased whenever the task 
exits or is checkpointed to the disk. The access count determines 
when as SGA is to loaded cr unloaded. 
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5.4.2 Loading Principle for an SGA 


When a task that links to an SGA is requested, the Executive prepares 
to load the task and at the same time checks the GCD entries for the 
SGA to determine their status. If the SGA is not loaded, the 
Executive prepares to load it as well. 


The actual loading of the task and any of its related SGA is attempted 
only if memory can be found for all of the components (task and SGAs) 
of the load. If an SGA already is loaded, no attempt is made to load 
it again. The access count provides the Executive with this 
information. When the task and its SGAS have been loaded 
successfully, the access count for each SGA is increased by one. 


5.4.3 Task Exit/Checkpointing and Unloading SGAs 


When a task relinguishes its memory by exiting or being checkpointed, 
the access count for each SGA that it refers to is decreased by one. 
If the Executive determines that the access count is now zero for an 
SGA, it unloads the SGA by releasing the memory allocated to it. If 
the SGA is a common area, i.e., if it is read/write, it is written to 
disk also, and then memory is released. Read/write SGAS are written 
back to the disk at the physical block where the file was positioned 
at install time. The writing back will occur even if the file is 
deleted and may corrupt any subsequent file on the disk. Therefore, 
do not delete the task image file until the SGA has been removed. 


The result of this approach is that a single SGA remains in memory as 
long as its access count is greater than zero regardless of how many 
tasks refer to it, exit, or are checkpointed. 


5.5 CHARACTERISTICS OF SGAs 


The characteristics of SGAs described in the following paragraphs 
should be kept in mind when designing the use of SGAs. 


l. Every load of an SGA requires another disk access if the SGA 
is not fixed or already loaded. The result is that a_ task 
that refers to two SGAs, neither of which is loaded, requires 
three disk accesses to activate the task, i.e., orfe for the 
task and one for each SGA. 


This process applies to multiuser tasks with pure areas as 
well. These tasks require two disk accesses to load _ them: 
one for the read/write area and one for the read-only (pure) 
area. 


This does not apply to nonmultiuser tasks or to multiuser 
tasks with no pure area. 
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Every regquest of a task and its related SGAs requires one I/0 
request node to be picked for every component of the _ load. 
For example, if a task has a read-only area and links to an 
SGA, three I/O request nodes are picked at task request time. 
If the nodes cannot be picked, the request is rejected with 
the standard error return. 


2. SGAS can map over the external page by use of the 
pseudo-partition name S$SSEXT at INSTALL time; however, an 
actual load of such an SGA does not occur. The simplest 
procedure for such an SGA is shown in the following example. 


Assembly code example: 
- TITLE EXTPAG 


START: .BLKW 58 ; IGNORE FIRST 58 WORDS 
: OF EXTERNAL PAGE 


XX33 - WORD g ; AN INTERESTING REGISTER 
vie - WORD ) ; ANOTHER INTERESTING REGISTER 
; BOTH GLOBALLY DEFINED 
- END START 


Task build procedure example: 


TKB [1,1] EXTPAG/-HD,LP:/CR,SY: [1,1] EXTPAG=[208, 200] EXTPAG 


/ 

STACK = @ 

UNITS = @ 

BASE = 12 ; MAP IT UNDER ASR 3 


7. 
TKB TASK,MAP=TASK 


COMMON=EXTPAG : RN 


3. The original copy of an SGA installed as a common area is 
updated when the SGA is unloaded. This characteristic should 
be considered when designing a system restart procedure. 


To retain the original task-built version of a common area, use PIP to 
make a second version of the file. When the SGA is installed, the 
file with the higher version number is selected for installation. 
Because the original version is never installed, it is not modified 
when the common area is written onto the disk. The modified version 
is the one with the higher version number. 


To reinitialize the common area with its original data, remove’ the 
common area from the system, delete the copy of the common area with 
the higher version number, make another copy of the original data 
file, and reinstall the common area. 


5.5.1 Fragmentation and Lockouts 


The system Manager must avoid lockout conditions due to the 
unavailability of memory. The following points must be understood. 


6. 


The follo 


i... 


2 


5.6 FIXI 


GLOBAL LIBRARIES AND COMMON AREAS 


No attempt is made to load a task until memory has been found 
for all components (task and SGAS) of the load. 


The necesSary memory need not be contiguous for’ each 
component; i.e., the memory for an SGA can be discontiguous 
from the memory required for the task. Memory is allocated 
contiguously on a component basis, i.e., for the task or SGA 
level. 


Attempts to allocate memory for a task are always made for 
the highest priority task in the MRL. 


If a lower priority task fits in an area of memory that is 
too small for the higher priority task, the lower priority 
task is not loaded. 


A task is not considered checkpointable unless it is being 
loaded or is actually running. 


No moving of currently running tasks is performed to make 
room for a task desiring memory. 


wing rules should be applied when designing the use of SGAs. 


SGAs should be installed into their own partition or into the 
same partition as the tasks that use them. 


Multiuser tasks with read-only areas should be requested into 
the partition into which they were installed. 


NG AN SGA IN MEMORY 


An SGA ca 
using the 


n be fixed in memory by fixing a dummy task that uses the SGA 
FIX command to MCR. 


The dummy task should be built with the following options, which are 


described in the RSX-11D Task Builder Reference Manual: 
/-CP /-FP /FX 
STACK = 186 
UNITS = @ 
LIBR = sga name Or COMMON = sga name 
The dummy task uses 96 words; this includes the task header and 


minimum s 


tack size, plus one FTL entry. The above approach is’ the 


optimal solution to fixing an SGA. 


Fixing the dummy task results in the loading and fixing of the SGA 


that it u 


ses. 


The following is an example of a dummy task. 


START: EXITSC 


-MCALL EXITSC 

EXITSC is included in 
case the task is 

ever executed 


e-END START 


=e we “SO 


CHAPTER 6 


CORE DUMP ANALYZER 


The Core Dump Analyzer (CDA) program allows the user to analyze _ the 
state of the software at the time of a system crash. The term ‘crash’ 
refers throughout this chapter either to an actual system crash or to 
a crash forced by the operator. 


When a crash occurs, and provided the Executive has been built with a 
crash module appropriate to some dumping device, an area of memory is 
automatically dumped on that device. When the system is again 
running, the operator can request CDA to analyze the core dump. The 
same system should be used as the one that crashed. CDA can be run at 
the same time as other tasks. 


NOTE 
In order to benefit fully from CDA 
output, the user must be familiar with 


the RSX-11D Executive and with the 
PDP-11 Processor Handbook. 


The output from CDA is a listing. The information listed falls into 
two categories, standard and optional. 
The standard information is: 


1. An analysis of the system status at the time the core dump 
was taken and an indication of the cause of the system crash, 


2. The content of all the central processing unit registers and 
memory management (KT11) registers, 


3. The content of the SCOM data area and checkpoint bit map. 
The optional information is: 


l. An analysis of all tasks active at the time of the crash 
including the interpretation of their headers, 


2. An analysis of all system lists, 


3. A verification of the system node pool including a comparison 
of the nodes allocated with those nodes in use in lists, 


4. A complete dump of the system node pool in three output 
formats (octal, ASCII, and Radix 58), 


5. A dump of the adcress space of any task that has memory 
allocated at the time of the crash. 
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6. A dump of a named Shareable Global Area (SGA). 


Standard information is always listed. Optional information is listed 
only if the appropriate option switches are included in the command 
sequence that calls CDA. Standard information is described in Section 
6.1. Optional information is described in Section 6.2. 


CDA may be called more than once, if desired to analyze the same core 
dump. 


Appendix A contains a sample CDA listing that is referred to for all 
examples throughout this chapter. 


6.1 STANDARD INFORMATION PRODUCED BY CDA 


The standard CDA information is system data and is printed at _ the 
beginning of the core dump analysis. See pages 1 through 3 of the 
sample analysis in Appendix A. 


6.1.1 Crash Stack 


The first page of output from CDA displays the data recorded on _ the 
crash stack at the time the dump was taken. The crash stack refers to 
the data area that is internal to the crash module. It contains the 
following information. 


1. Cause of the crash -- The specific reason for the system 
crash, e.g., 


SST EXECUTED IN KERNEL MODE 


If the crash dump was obtained by some means other than an 
Executive crash module, i.e., by a stand alone program as 
described in Section 6.5, the following message is printed. 


MANUAL DUMP BY OPERATOR 


2. The processor status register (PS), the kernel stack pointer 
(SP) and the user SP after the crash --— If the crash was 
forced by the Executive, these registers reflect the content 
of the respective registers after the IOT (I/O trap) 
instruction has been executed. 


3. The program counter (PC) and PS before the crash -- If the 
crash was forced by the Executive, the content of these two 
registers is pushed onto the kernel stack by the I0T 
instruction. The PC value is eguated to a specific global 
crash code whenever the .CRASH macro appears in the Executive 
code. 


4. R@ through R5. 


5. Segmentation status registers §@ through 3. On a PDP-11/40, 
not all of the registers are present. Refer to the PDP-1l 
Processor Handbook. 


6. All of the segmentation registers for user, supervisor, and 
kernel modes for both I and D space. On a PDP-11/49, not all 
of these registers are present. Refer to the PDP-11l 
Processor Handbook. 
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The information contained in the ‘crash stack is the key to _ the 
operation of CDA. In particular, the contents of the kernel PARs 
enable CDA to convert virtual memory addresses into the physical block 
and word addresses of the dump medium. 


6.1.2 Kernel Stack. 
The kernel stack of 128 words is dumped on the second page of the CDA 
output. The location of the kernel stack is determined from the 


symbol .SG.TS in the Executive, which is the top of the Executive 
stack. 


6.1.3 System Communication Area (SCOM) 
The system communication area (SCOM) data area is dumped on the third 
page of the CDA output. The contents of the following SCOM items are 
interpreted. 

1. Time of the crash 

2. Current task name and ATL address (.CRTSK) 

3. PDP-11/45 floating point hardware indicator (.FP45X) 

4. Processor type (.PDP11) 

5. Size of memory in 32-word blocks (.MSIZE) 

6. Size of the checkpoint file (.CKFSZ) 

7. Significant event flags (.SERFG) 

8. System event flags (.COMEF) 


9. The entire SCOM data area from .SG.BC to .SG.EC 


6.2 OPTIONAL OUTPUT FROM CDA 


Optional output from CDA is obtained by including the. appropriate 
switches in the command string that calls CDA, as described in Section 
6.3. 


All switches are presented in alphabetic order by switch name for ease 
of reference. However, anyone unfamiliar with CDA should read all 
eescriptions before using the following information for reference 
purposes. Also, refer to the tables and lists described in the 
RSX-11D Executive Reference Manual. 
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6.2.1 All Lists (/ALL) 


When the /ALL switch is included in the command string, CDA includes 
the following information in the printed output. 


1. AST queues 

2. Active task list 

3. Batch command buffers 

4. Clock queue 

5. Fixed task list 

6. Global common directory 

7. Task headers 

8. MCR command buffers 

9. System node pool 

1@. Physical unit directories (PUDs) 

11. SEND/RECEIVE queues 

12. STD entries 

13. Task partition directories 

14. Verification of the system node pool 
Using the /ALL switch is equivalent to including all CDA command 


Switches except /TAS, /DMP and /SGA. These last three are used_ to 
dump specified portions of memory. 
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6.2.2 AST Queues (/ASQ) 


A dump of the AST queues is included if the /ASQ switch is used. 
page 46 of the sample listing for an example of AST queue output. 


The /ASQ 


switch causes all tasks which have any entries in their 


gueue to have such output. Note that the AST queue also includes 
requests which have been completed but for which the task has not 
been notified. 


For each task with ASTs pending, the task name, ATL address (real 


virtual) 


and STD address are output as a heading. 


I/O completion entries are output as: 


1. 
2. 
3. 
4. 


5. 


6. 


For true 
l. 
2. 


3. 


AST entry point, if any 

Event flag number specified in the QIO 
I/O status block address 

I/O status block contents (two words) 


Intermediate buffer address (real and virtual) 
(RSX-11D intermediate buffered transfer only) 


User virtual buffer address (RSX-11D intermediate 
buffered transfers only). 


AST entries the output is: 
AST type 
AST entry point 


Additional information, if any, which will be pushed on 
the user ’s stack. 


See 


AST 
I/O 
yet 


and 


to 
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6.2.3 Active Task List (/ATL) 

A dump of the active task list is included in CDA output if the /ATL 
switch is used. See page 4 of the sample listing for an example of 
ATL output. 


The /ATL switch causes all entries in the ATL to be listed and 
provides interpretation of the following items in the order described. 


1. ATL address -- virtual and real address nodes 
- STD address -- virtual and real address nodes 
- REQUESTER -- name of the task that requested this task 


. Load address -- real memory address of the task’s header 


2 
3 
4 
5. Name of the partition in which the task was running 
6. The task’s run priority 

7. I/O in progress count 

8. I/0 pending count 


9. Status -r the same 2-character codes as those used by ...ACT 
as described in the RSX-11D User's Guide 


10. TI assignment -- the terminal from which the task is being 
run 


ll. Flag word -- A.TF 
12. Flags -- task’s 32 event flags (two words) 
13. Masks -- task’s 64 event flag masks (four words) 


14. Entire ATL node dumped with virtual addresses 
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6.2.4 Batch Command Buffers (/BAT) 

A dump of the batch command buffers is included in CDA output if the 
/BAT switch is used in the command string. On page 44 of the example, 
the sample listing indicates that no batch command buffers were in use 
at the time of the crash. 

The format of CDA output for the batch command buffer is the same as 
the format for the MCR command buffers shown on page 43 of the sample 
listing. 


The /BAT switch causes all the batch command buffers to be dumped and 
provides interpretation of the following items for each buffer. 


1. Node address -~- virtual address of the node 

2. Name of the MCR task requested 

3. TI assignment -- terminal initiating the batch job 
4. Length of the buffer 


5. The first 4@ characters in the buffer converted to ASCII 
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6.2.5 Clock Queue (/CKQ) 


A dump of the clock queue is included in CDA output if the /CKQ switch 
is used. See page 48 of the sample listing for an example of CKQ 
output. 

The /CKQ switch causes all entries in the clock queue to be dumped. 
The format of the output depends on the type of the clock queue entry. 
For all types, the first line indicates the type and the time in ticks 
which must elapse after the previous entry before this entry will be 
dequeued (the “Delta” time). 

The types are: 


a. Time-slice, for the RSX-11D time-slicing scheduler. 
No further information is output. 


b. Mark time. The following is supplied: 
1. Task name 
2. ATL address - virtual and real node address. 
3. Event flag number 
4. AST entry point address 


c. Schedule, that is, a request for a task to run at a specified 
tiime. The additional information is: 


1. Name of requested task 


2. STD address of reguested task - real. and virtual 
addresses. 


3. Task name of requestor. 
4. STD address of requestor - real and virtual addresses. 


5. Partition specified for task to run in, or blank if no 
task specified. 


6. Priority specified for task, or zero if no _ priority 
specified. 


7. UIC specified for task to run under, or [8,8] if no UIC 
specified. 


8. TI for which the task will run. 


d. Reschedule, that is, a schedule which is to be repeated at a 
regular interval. The additional information is as for 
“schedule” in c. above, with the addition of the interval 
between periodic reschedules, in ticks. 
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6.2.6 Dump of Real Memory (/DMP) 


The /DMP switch causes a portion of real memory to be dumped in three 
notations: octal, ASCII, and radix 5@. The /DMP switch has’ the 
following syntax. 


/DMP:start:end 

start is the starting real memory address. An octal 
number representing up to 22 bits is used. 

end is the ending real memory address. An octal 


number representing up to 22 bits is used. 


Both the starting and end addresses must be specified. Only one /DMP 
Switch can be specified. 


6.2.7 Fixed Task List (/FTL) 


A dump of the fixed task list is included in CDA output if the /FTL 
Switch is used. See Page 45 of the sample listing for an example of 
FTL output. 


The /FTL switch causes all entries in the FTL to be listed and 
provides interpretation of the following items in the order described. 


1. FTL address -- virtual and real address nodes 

2. STD address -- virtual and real address nodes 

3. Load address -- real memory address of the task’s header 
4. Name of the partition in which the task was running 

5. The task’s run priority 


6. I/O in progress count 
7. I/O pending count 
8 


- Status -- the same 2-character codes as those used by ...ACT 
as described in the RSX-11D User’s Guide 


9. TI assignment -- the terminal from which the task is being 
run 


18. Flag word -- A.TF 
ll. Flags -- task’s 32 event flags (two words) 
12. Masks -- task’s 64 event flag masks (four words) 


13. Entire FTL node dumped with virtual addresses 
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6.2.8 Global Common Directory (/GCD) 


A dump of the global common directory is included in CDA output if the 
/GCD switch is included in the command string. See pages 49 and 58 of 
the sample listing for an example of GCD output. 

In addition to the entries in the GCD itself, entries linked to STDs 
for the pure area of a multiuser task also are dumped. The formats of 
both types of nodes are identical except that pure area GCD nodes do 
not contain the name of the task. Instead, an octal 35 (an illegal 
radix 5@ character) is in the first word of the name. The following 
items are interpreted for each GCD when the /GCD switch is specified. 


1. Name of the common block or library, or octal 35 if the node 
is for the pure area of a task 


2. Virtual address of the GCD node 


3. Size -- 1/64th of the size of the common block, library, or 
pure area 


4. Name of the partition in which the shared area is installed 
5. Flags byte 


6. Status of the global area using the same 2-character codes as 
---ACT with the addition of NL to indicate not in use or not 
loaded 


7. Active reference count and installed reference count 
separated by a slash (/) 


8. Creation time 


9. UIC 
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6.2.9 Task Headers (/HDR) 

A dump of the task headers is included in CDA output if the /HDR 
switch is included in the command string. See pages 8 and 9 for an 
example of task header output. 


Interpretation of the following items is provided in addition to the 
dump of the headers. 


1. Header address -- real address of the task’s header 
2. ATL address for the task 
3. H.CR1 -- context buffer reference point 1 
4. User PDRS 
5. User PARS 
6. PS, PC, R® through R5, and SP 
7. j%Initial PS, PC and SP 
8. Size of the header in 32-word blocks 
9. Directive status word (DSW) -- task’s virtual zero 
18. Number of LUNS assigned to the task 
ll. Logical unit table (LUT) -- the device and unit address’ for 
each entry in the LUT. If there is a window open for the 
entry, the following additional items are dumped. 
From the window: W.CTL, W.VBN, W.FCB 
From the FDB: F.FNUM, F.FSEQ, F.STAT, F.NACS, F.NLCK 


12. The entire header is dumped. 


6.2.18 MCR Command Buffers (/MCR) 

A dump of the MCR command buffer is included in CDA output if the /MCR 
switch is used in the command string. See page 43 of the sample 
listing. 


The /MCR switch cauSes all MCR command buffers to be dumped and 
provides interpretation of the following items for each buffer. 


1. Node address -- virtual address of the node 

2. Name of the MCR task requested 

ae. EE assignment -- terminal initiating the batch job 
4. Length of the buffer 


5. The first 4@ characters in the buffer converted to ASCII 
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6.2.11 Dump of System Node Pool (/POL) 

Inclusion of the /POL switch causes the entire system node pool to be 
dumped with virtual and real addresses (see pages 54 and 55 of the 
sample listing). Each node (8-word block) is dumped in three formats: 


octal, ASCII, and radix 5@. In addition if the node is in use 
(allocated), an asterisk (*) is printed at the lefthand margin. 


6.2.12 PUDs and I/O Request Queues (/PUD) 
Inclusion of the /PUD switch causes all peripheral unit aivectories 
(PUDs) to be dumped. If any I/O requests are queued for the device 
type, the I/O request nodes are dumped after each associated PUD. See 
pages 31 and 32 of the sample listing. 
The following items are interpreted for each PUD entry. 

1. Device name and unit number 

2. Flag byte 

3. Name of the task attaching the device, if any 

4. Device to which this one has been redirected 

5. Handler task name 

6. Count of express requests in the queue (EXP CNT) 

7. U.CH -- characteristics word in PUD (CHAR) 


8. First three characters of the default ACP task name in radix 
5@ (DACP) 


8. Name of the ACP task 
9. Terminal flag bytes (TERM) 


11. A dump of the entire PUD 
The following items are interpreted for the I/O request node. 


1. Name of the task generating the I/O recuest 

2. ATL node address of the requester 

3. Size of the DPB (DPB SZ) 

4. Priority of the request 

5. LUN 

6. Event flag number (EFN) 

7. Function code -- if the function code is one of the more 
common function codes, it is printed symbolically, e.g., 
IO.WLB. If it is not a common code, IO.XXX is printed. 


8. Request type -- either normal or express 


9. A dump of the entire I/O request node 
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6.2.13 Dump of an SGA (/SGA) 


The /SGA switch is used to dump a shareable global area (library or 
common area). The SGA must have been resident in memory. 


The /SGA switch has the following syntax, with brackets indicating the 
optional portion: 


/SGA=sganamel [:start:end] 
where: 
sganame is the name of the SGA to be dumped 


start is the starting virtual address in octal of the portion 
of the SGA to be dumped. 


end is the ending virtual address in octal of the portion 
of the SGA to be dumped. 


Default: if the start and end addresses are omitted the entire 
SGA is dumped. 


For a position-independent SGA, addresses are assumed to start at @, 
both in the dump and in reckoning the ‘start’ and ‘end’ values. For a 
non-position-independent SGA, addresses correspond to those used when 
the task was built, e.g. an SGA mapped through APR3 would start at 
60000. 

This switch may only appear once in a CDA command string. See pages 


162 and 193 of the sample listing for an example of the output 
obtained by using the /SGA switch. 


6.2.14 SEND/RECEIVE Queues (/SRQ) 
Inclusion of the /SRQ switch (see page 47 of the sample listing) 
causes all the SEND/RECEIVE queues to be listed and _ provides 
interpretation of the following items for each queue. 

l. Task name of the receiver 

2. Task name of the sender 

3. TI -- terminal of receiver or sender task 


4. Priority of the send 


5. Data block contents 
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6.2.15 System Task Directory Entries (/STD) 
Inclusion of the /STD switch causes all the entries in the system task 
directory (STD) to be dumped. See pages 22 and 23 of the sample 
listing. When /STD is used, CDA provides interpretation of the 
following items for each STD entry. 

1. Name of the task 

2. Name of the partition in which the task is installed (PAR) 

3. STD flag word 

4. Priority at which the task is installed (PRI) 

5. Disk from which the task is installed (DISK) 

6. Size of the task (SIZE) -- S.TZ 

7. Number of active versions of the task (AV) 

8. Pool limit specified in 8-word blocks (LIM) 

9. Pool utilization specified in 8-word blocks (UTIL) 


19. SRO listhead 


6.2.16 Dump of Task’s Address Space (/TAS) 


Inclusion of the /TAS switch causes the address space of a task that 
has memory allocated to it at the time of the crash to be dumped (see 
Pages 16@ and 101 of the sample listing). The task must have been 
either active or fixed in memory. Each task area is dumped in three 
notations: octal, ASCII, and radix 5@. 


The /TAS switch has the following syntax with brackets indicating the 
optional portion. 


/TAS=taskname[s:start:end] 
taskname is the name of the task to be dumped 


Start is the starting virtual address in octal for the 
portion of the task to be dumped 


end is the ending virtual address in octal of the 
portion of the task to be dumped. 


If the starting and ending addresses are omitted, the entire task is 
dumped. When this switch is used to dump a multiuser task, only its 
impure area is dumped. 


NOTE 


Only tasks with entries in the STD can 
be dumped using the /TAS switch. Pure 
areas of multi-user tasks cannot be 
dumped. 


CORE DUMP ANALYZER 


6.2.17 Task Partition Directory (/TPD) 


Inclusion of the /TPD switch causes all entries in the task partition 
directory to be dumped. Also dumped are any entries in the memory 
required list (MRL) or the checkpointable task list (CTL) for each 
partition. An allocation map is printed for each partition showing 
the unused area, active and fixed tasks, and shared areas in the 
partition. See pages 19 and 2@ of the sample listing. 


The following items are interpreted for each partition. 

1. Partition name 

2. TPD entry address -- virtual and real address of TPD entry 

3. Base address -- real starting address of the partition 

4. Size of the partition in bytes 

5. TPD flag word 

6. Unused areas (HOLES) -- if the partition is 
system-controlled, the address and size of each unused area 
is printed. 

7. Allocation map -- all active or fixed tasks and shared areas 
in the partition are listed with the real address of the 


space allocated. One of the following letters is used _ to 
indicate the type of task or area. 


A -- active task 

F -- fixed task 

P -- pure area of multiuser task 
L -- library 

C -- common block 


If the partition has any entries in the memory required list (MRL), 
the following items are interpreted. 


l. Virtual address of the MRL node (NODE ADR) 
2. Name of the task 

3. Size of the task (SIZE) -- S.TZ 

4. Run priority of the task 

5. Checkpoint priority (CP PRI) 

6. Status (STS) 

7. Checkpoint status (CP STS) 

8. I/O node address 


94. TI 
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If the partition has any entries in the CTL, the following items are 
interpreted. 
1. CTL node address 
2. Name of the task 


3. Run priority 


r= 
° 


Status (STS) 


5. TI 


6.2.18 Verification of System Node Pool (/VFY) 


Inclusion of the /VFY switch causes the system node pool to be 
verified (see pages A-16 and A-17 of the sample listing). The following 
procedures are used to verify the node pool. 


1. The number of nodes (8-word blocks) in use is determined. 


2. The total number of nodes in the pool also is_ calculated 
using the following formula. 


Total number of nodes = (Mod32(.STDTA+(.STDTC*2) )-—.PUDBA/8 


-STDTA is the starting address of the STD alpha table. 
-STDTC is the capacity of the STD. .PUDBA is the beginning 
address of the PUD. 


This formula provides the total number of nodes available in 
the pool, i.e., those that are not allocated permanently to 
fixed lists such as the PUD, TPD, and STD alpha table. 


3. All the dynamic system lists are scanned to find the nodes 
that have been picked from the pool. The lists that are 
searched include the following. 


Fixed task list 

Batch command buffer 

I/O request nodes 

Volume control block 

Vector connection (..CINT) nodes 
AST nodes 

Window nodes 

AST nodes linked to task headers 
Active task list 

CKQ (clock gueue) 

GCD nodes 

I/O nodes linked to GCD nodes 
MCR command buffer 

Memory required list 

I/O nodes linked to MRL nodes 
AST nodes linked to MRL nodes 
System task directory 
SEND/RECEIVE Queue 

Pure area GCD nodes 


As a result of this search, a bit map is constructed to show 
which nodes are in use in system lists. Although every list 
is searched, it is still possible to miss some nodes because 
any privileged task can pick nodes. For example, the 
teletype handler uses nodes for read-ahead buffers. Nodes in 


6-16 
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use for privileged tasks are not found when the system lists 
are searched. 


4, The bit map created in step 3 above is scanned and the number 
of nodes marked as being in use is printed. 


5. The pool is tested for discrepancies. First, the nodes 
actually allocated, but not found in any list, are dumped. 
There always are some of these. 


Next, the nodes found in the lists, but not allocated, are 
dumped. If there are any of these, they should be examined 
carefully. They indicate that the current pool allocation 
does not reflect the status of the nodes in the pool 
accurately. 


6. Finally, the bitmaps representing the nodes allocated and the 
nodes found in the lists are dumped. 


6.3 OPERATIONAL INFORMATION 
The operational information required for CDA includes the process of 


linking a crash module into the Executive (Section 6.3.1) and the 
command string used to call CDA (Sections 6.3.2 and 6.3.3). 


6.3.1 Linking a Crash Module into the Executive 


In order for a crash module to write the dump that provides CDA with 
input, a crash module must be linked into the Executive. 


The command file [11,15] TKB15.CMD is used as input to the task builder 
for this purpose. Appendix B provides a listing of the command file. 


To link the crash module into the Executive, replace NCRASH.OBJ with 
one of the following crash modules: 


TC11CM or TC11CR to dump onto DECtape, 

TU1@CM or TU1#OCR to dump onto TU1# magnetic tape, 

TU16CM or TU16CR to dump onto TU16 magnetic tape, 

RK#95CM or RK#@5CR to dump onto RK@5 disk. 
The modules with names ending in the letters CM are the same as those 
with names ending in CR except that the CM versions cause more 


detailed messages to be printed on the console at the time of a crash. 


If none of the crash modules is needed, but the more detailed console 
messages are desired, replace NCRASH.OBJ with the module MCRASH.OBJ. 


Refer to the listing in Appendix B to determine default unit numbers 
for the crash modules and how to modify them. 


Rebuild the Executive using the TKB15.CMD file and rebuild the 
bootstraps using {[11,17]BOOTSBLD.CMD. Then rebuild CDA using 
[11,13] CDABLD.CMD. 
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6.3.2 Calling CDA 


Core dump analyzer is a task that can execute online with other tasks. 
Type the following command to MCR to install CDA. 


MCR>INS [11,1]CDA 
The following command syntax is typed to MCR to request CDA. 
MCR>CDA [option switches] 


option switches are those switches described previously in 
Section 6.2 and summarized in Table 6-1 
below. Any combination of switches can be 
used, or all switches can be omitted. 


Table 6-1 
Summary of CDA Option Switches 


SWITCH FUNCTION 


/ALL Lists the same information as _ produced 
by using all CDA option switches except 
/TAS, /SGA and /DMP. 


/ASQ Lists and interprets ASTs and I/O 
requests completed but not yet notified 
to the task. 


/ATL Interprets and dumps ATL entries. 


/BAT Interprets and dumps batch command 
buffers. 


/CKQ Interprets and dumps clock queue 
entries. 


/DMP:start:end Causes a specified portion of memory to 
be dumped. 


/FTL Interprets and dumps the fixed task 
bi St. 


/GCD Interprets and dumps GCD entries for 
libraries, global common areas, and 
multi-user task pure areas. 


/HDR Interprets and dumps individual task 
headers. 


/MCR Interprets and dumps MCR command 
buffers. 


/POL Dumps the node pool in octal, ASCII, and 
Radix 56. 


/PUD Interprets and dumps PUD information. 


(Continued on next page) 
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Table 6-1 (Cont.) 
Summary of CDA Option Switches 


SWITCH FUNCTION 


/SGA=sganame[:start:end] Dumps all or part of a named SGA 


/SRQ Interprets and dumps SEND/RECEIVE 
queues. 


/STD Interprets and dumps STD entries. 


/TAS=taskname[:start:end] Dumps all or part of the task’s address 
space for a task that has memory 
allocated to it. 


/TPD Interprets and dumps all entries in the 
task partition directory. 


/VFY Causes verification of the system node 
pool. 


NOTE 
The CDA input LUN is assigned to DT@. 
To change this assignment, use the REA 
command as in the following example 
before calling CDA. 


MCR>REA ...CDA 3 DKI1: 


6.3.3 Examples of CDA Command Strings 
The following are examples of CDA command strings: 
Example 1: 

MCR>CDA 

Result: Only the system data is printed. 
Example 2: 

MCR>CDA /ALL 

Result: All the optional output is printed. 
Example 3: 

MCR>CDA /POL 

Result: The system node pool is dumped. 
Example 4: 

MCR>CDA /ATL/HDR 


Result: The ATL nodes and task headers are dumped for those 
tasks that were active when the system crashed. 


Example 5: 
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MCR>CDA /PUD/TAS=TT.... 


Result: 


Example 6: 
MCR>CDA 


Result: 


Example 7: 


All the PUD’s are dumped followed by a dump of the 
entire task "TT....". 


/TASK=XYZ:9: 2600 


If the task XYZ had memory allocated at the time of the 
crash, its virtual address space from § to 2908 is 
dumped. If no memory was allocated for XYZ a message is 
printed instead. 


MCR>CDA /DMP: 4480908: 4430090 


Result: 


Real memory from 4498008 to 443080800 is dumped. 
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6.4 OPERATOR ERROR MESSAGES 


The messages listed in Table 6-2 are reported on the console 
requesting CDA when an error is detected that prevents CDA performing 
the analysis. “Input device’ is the device on which the memory dump 
is held and which provides the input to CDA. 


Table 6-2 
CDA Error Messages 


DEVICE READ Input device is not Check status of device. 
ERROR ready or is other- Call field service if 
wise unavailable. . problem persists. 


PLEASE MOUNT Input device not Mount the input de- 
INPUT DEVICE AS mounted as a foreign] vice as foreign. 
FOREIGN volume. 


DEVICE HANDLER The device handler Load the handler, then 
MISSING for the input device; retype the command 
is not loaded. string. 


FAILED TO READ CDA was not invoked Execute CDA as an MCR 
MCR COMMAND as an MCR function. function, not with 
BUFFER RUN. 


SYNTAX ERROR There is a mistake in Correct the error and 
the command string. retype the command. 


ILLEGAL SWITCH An unrecognized Type in the command 
Switch was found in string again using 
the command string. the correct switch. 


DUMP ABORTED - Either the crash Try to obtain another 
KERNEL PAR’S clobbered the PAR‘s crash. 
CLOBBERED or the format of the 

crash stack on the 

dump medium is in- 

correct. 
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6.5 INPUT TO CDA 


The usual source for input to CDA is the dump produced by one of the 
RSX-11D Executive crash modules that can be linked in when the 
Executive is built (see Section 6.3). If the dump has been made by one 
of these modules, it is possible for CDA to report the cause of the 
crash. 


6.5.1 Forcing a Crash 


It is also possible that the user would like to crash the system in 
order to study the dump produced. 


The executive can crash for any of the following reasons: 


Odd Address or TRAP 4 
Undefined System Event 
AST Node Pick Failure 
Floating Point Error 
Memory Parity Error 
Non-RSX-EMT execution 
Reserved Instruction 
SST in Kernel Mode 

Red or Yellow Stack 
EMT 377 in Kernel Mode 
Undefined System Error. 
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A crash is forced by generating one of the above conditions. The two 
easiest methods are 1 and 9. 


An ‘odd address or trap 4° can be generated by halting the processor, 
setting the Program Counter (PC) value odd, and continuing. 


A “Red or Yellow Stack” can be generated by halting the processor, 
depositing zero into the Kernel Stack Pointer, and continuing. 


The Console Switches are used to halt, set an appropriate value and 
continue. See the section on the Operator ’s Console in the Processor 
Handbook for the model involved. 


NOTE 
Causing an active, running system to 
crash may result in serious 
consequences. It always causes a 


complete loss of all data in memory. It 
can cause corruption of disk file 
structures. Use extreme caution, e.g., 
write protect disks first. 


6.5.2 Dumps from Stand-alone Programs 


Occasionally, none of these methods causes a crash; e.g., the system 
is dead or in a very tight loop. For this reason, various techniques 
have been developed for dumping a system without using the crash 
modules. 


All of these technigues involve bootstrapping a stand-alone program 
into memory. The most common technique is to bootstrap a program from 
DECtape. This program proceeds to write the dump on the DECtape. 
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CDA can interpret the dumps from stand-alone programs if the following 
conditions are met. 


is 


The memory dump begins at block 181 (octal) for disks or 
DECtape or at physical record 2 for magnetic’ tape. The 
memory dump must begin at real memory location Q@. 


Block 198 (actal) or record 1 must be formatted in a specific 
way and must include at least the kernel PARS in particular 
locations. For the precise format of this information, refer 
to Figure 6-1. 


NOTE 


If the dump was not made by an Executive 
crash module, the first 28800 (octal) 
bytes of real memory may be lost because 
the hardware bootstraps for some 
devices, notably DECtape, use the first 
2008 bytes. In certain cases, losing 
these 2808 bytes can be critical, 
especially if the kernel stack extends 
into that area. 
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THE INTERNAL STACK CAT SENDST!) CONTAINS THE FOLLOWING INFORMATION? 


($P4340 18 AT LOCATION 'ENDST!) 


8P4334 es PROGRAM STATUS WORD APTER BO0T 

8P4332 em KERNEL SP AFTER BOOT 

SP4330 em PC BEFORE CRASH YOY (FROM KERNEL STACK) 
8P4326 es P§ BEFORE CRASH JOT CFROM KERNEL STACK) 
SP4324 ee USER SP 

S$Pe322 ew RA CREGISTER SET 1) 

$P4320 es Ri 

SP4316 ee RP 

$P4314 ow RJ 

SPe3i2 em R4 

SPe310 ee RS 

SP4306 e= SEGMENTATION STATUS REGISTER @ 

SPe30d es SRI 

8P43A2 eo SRO 

$P4308 oe SR3 

SP4276 ew USER I SPACE DESCRIPTOR REGISTER B 

s 

s 


§P3260 wm USER I SPACE DESCRIPTOR REGISTER 7 
$P4256 ee USER D SPACE DESCRIPTOR REGISTER B 
a 
r 


8P4240 oe USER D SPACE DESCRIPTOR REGISTER 7 
$P4236 ea USER I SPACE ADDRESS REGISTER @ 

s 

s 


P9220 ew USER I SPACE ADDRESS REGISTER 7 
8Pe162 ee USER D SPACE ADDRESS REGISTER 6 
a 
s 


SP+20@ ew USER D SPACE ADDRESS REGISTER 7 
SP6176 em SUPERVISOR I SPACE DESCRIPTOR REGISTER 2 
a 


$Ps160 ee SUPERVISOR I SPACE DESCRIPTOR REGISTER 7 
SP4156 ew SUPERVISOR D SPACE DESCRIPTOR REGISTER B 
r 
2 


SPo140 we SUPERVISOR 0 SPACE DESCRIPTOR REGISTER 7 
SP4136 ee SUPERVISOR I SPACE ADDRESS REGISTER @ 


? 
s 


e.., 

$P4120 ee SUPERVISOR I SPACE ADORESS REGISTER 7 
$P4116 ew SUPERVISOR D SPACE ADDRESS REGISTER @ 
e 

2 


SP4190 ee SUPERVISOR D SPACE ADDRESS REGISTER 7 
$Ps076 ow KERNEL I SPACE DESCRIPTOR REGISTER @ 
a 
eo 


P4060 e= KERNEL I SPACE DESCRIPTOR REGISTER 7 
$P+056 we KERNEL 0 SPACE DESCRIPTOR REGISTER @ 


8P6040 ne KERNEL D SPACE DESCRIPTOR REGISTER 7 
$Ps036 «= KERNEL I SPACE ADDRESS REGISTER @ 

Aa 

a 


8P4020 we KERNEL I SPACE ADDRESS REGISTER 7 
$7416 e» KERNEL D SPACE ADDRESS REGISTER @ 


SPoa08 ewe KERNEL D SPACE ADDRESS REGISTER 7 


ennee NOTEG THE DeSPACE AND SUPERVISOR REGISTER LOCATIONS 
WILL CONTAIN RANDOM GARBAGE WHEN THE DUMP IS 
MADE ON AN 11/48, 


Figure 6-1 Format of CDA Input (Record 1 or Block 100) 
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TIME-SCHEDULED PARTITIONS 


RSX-11D supports a time-based scheduling algorithm as an aid to 
program development. The algorithm performs round-robin scheduling on 
all tasks of which the following are true: 


1. The task runs in a time-slice controlled partition, as 
defined at System Generation. 


2. The task, when installed, has a priority lying between limits 
defined in the system. 


The running of time slicing tasks takes place within the priority 
structure of RSX-11D. Tasks satisfying the above conditions will come 
under time slicing whether or not they are checkpointable (liable to 
rollout/rollin). 


7.1 TIME-SCHEDULING OF TASKS 
Round-robin scheduling has two time parameters: 


1. The CPU Burst, which is the length of time (number of clock 
ticks) that must pass before the current user of the CPU is 
changed. 


2. The Memory Swap Slice, which is the length of time (number of 
CPU bursts) that must pass before a resident checkpointable 
task is rolled out of memory, if the MRL is not empty. 


Other parameters are those associated with task priority. 


The mnemonics for these parameters and the values supplied in the 
released system are described in Table 7-1. 


A time sliceable task is a task which has been installed into a 
time-slice controlled partition at a priority of between 3 and PR.MAX. 


When such a task is loaded the task’s priority is set to the default 
value PR.DFL associated with time slicing. Normal RSX-11D processing 
then resumes. No time sliceable task will execute unless all tasks, 
whose installed priority is greater than PR.MAX, are idle. When the 
last time sliceable task exits, time slicing is turned off. 


When a CPU burst has been completed, the time scheduler is again 
activated. The Active Task List (ATL) is searched for the first task 
whose priority is equal to the default. This task is deleted from the 
ATL, and from the Checkpointable Task List (CTL) if it is 
checkpointable, and then reinserted into these lists as appropriate. 
This has the effect of “lowering” the task’s priority in the sense 
that all other equal priority tasks now precede it in the ATL. 
Another CPU burst is initiated and the scheduler becomes inactive. 
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By contrast, when a memory swap Slice has been completed the priority 
of each task, whose current MRL priority is between 3 and PR.MAX, is 
incremented by 1. In addition, the status of any task on the MRL whose 
priority is 2 is separately checked. The status of such a task can 
imply that it is now runnable, for example because of one of the 
following: 


1. an awaited event flag has been set 

2. the task has been resumed from a suspended state 

3. its status has been changed to ‘RUN’ 

4. an AST has been declared for it 

5. the task has been aborted 

6. an intermediately buffered I/O request has been terminated. 


If such a task with priority 2 is now runnable, its priority is raised 
either to the maximum time-slice value of PR.MAX or to its installed 
priority, whichever is the greater. 


At this point an attempt is made to activate the highest priority task 
on the MRL, firstly by a normal MRL scan and secondly by trying to 
force checkpointing for lower priority tasks. The first candidate for 
swapping out is the task now at the bottom of the list of those 
sharing the default priority. 


These attempts to activate the highest priority task on the MRL can 
still fail to provide the necessary memory. Normally the next step is 
to begin another memory swap slice. But if a task with priority 
PR.MAX remains at the top of the MRL for 3 memory swap times, then 
this task is “demoted”. Demotion is accomplished by subtracting PR.DEC 
from the task priority and reinserting the task, by priority, in the 
MRL. Demotion can be inhibited by setting PR.DEC=@. 


7.2 PRIORITY OF TASKS ON THE MRL 


When a task iS put on the MRL, either as a new reguest or as a 
roll-out, it has one of two priorities. These are: 


1. Its installed priority 


2. A priority value of 2. A task is given this priority whenever 
it is rolled out awaiting some external event which blocks 
additional execution. In this case the task is inhibited 
from contending for memory until the external event becomes 
due (see previous section). 


A task with a installed priority greater than the maximum time-slice 
priority will always be rolled in before any task whose priority is 
less than or egual to this maximum. This is because, during time 
slicing, MRL priority will never be incremented beyond this maximum. 


If, for example, PIP is installed into a time sliced partition with a 
priority of 55 and TKB is installed into a time sliced partition with 
a priority of 58, then as long as both PIP and TKB are on the MRL, PIP 
will be rolled in first. However, once PIP is rolled in, the MRL 
priority of TKB will continue to be incremented until, at some 
subsequent rollout of PIP, PIP will appear in the MRL after TKB, whose 
priority by now has been incremented to 55 or more. 
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Rollout is not initiated until there is a task on the .MRL whose 
priority is greater than or equal to the default time-slice priority. 
This ensures that low-priority “back-ground tasks” do not get rolled 
in as often as others. AS an example, if task X has been installed at 
priority 30, then since the default priority is 58, 28 memory’ swap 
Slices occur before task xX is even considered as a candidate for 
memory. 


A task will not be rolled out if its executing priority is greater 
than the MRL priority of the first (highest priority) task on the MRL. 
If there is not room in memory for the highest priority task on _ the 
MRL, no task of lower priority will be rolled in until the demotion 
algorithm, described above, takes effect. 


7.3 TIME SLICING PARAMETERS 


The following table summarizes the parameters involved in 7.1 and 7.2 
above. The period (.) indicates values in decimal. B indicates a 
byte value, W a word. 


Table 7-1 
Time Slicing Parameters 


Parameter | V6.2 System Meaning 
Value 


The execution priority of any task whose 
installed priority is between 3 and PR.MAX 
inclusive. (B) 


PR. MAX The maximum priority for CPU time slicing. 
If a task is installed with a priority 
greater than PR.MAX it will always execute at 
its installed priority. Also, if the task is 
on the MRL, it will always take precedence 
over all time sliceable tasks. (B) 


SL.BST The CPU burst which is the number of clock 
ticks before putting another equal priority 
task at the top of the ‘egual priority ATL 
subset’. (W) 


The memory swap slice which is the number of 
SL.BSTs before swapping is initiated. (W) 


The number of successive SL.SWPs before a 
task is demoted from the top of the MRL. (W) 


The amount by which a task’s priority is 
decremented when the time slicer decides to 
“demote” the task. (W) 
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7.4 LIMITATIONS OF TIME SLICING 


RSX-11D Time slicing is designed to cover program development - 
editing, assembling, linking - by one or more interactive users. In 
this way better service can be provided than by the standard priority 
scheduling of RSX-11D. It is not designed as a full timesharing system, 
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ERROR LOGGING 


In RSX-11D the logging of hardware is performed for both memory errors 
and device errors. The Executive log memory errors, which can be 
either main memory parity errors or cache memory errors on the 
PDP-11/78. Device handler tasks developed for RSX-11D log device 
errors. 


A single error log contains items logged by both the Executive and the 
device handler tasks. The system manager can use the output from the 
error logging analysis task to determine the reliability of memory and 
devices used in the RSX-11D system. 


Error statistics are accumulated by handlers for the following 
devices: 


e Disks, 
e DECtape, 
e Magnetic tape. 


For further information on the handling of parity errors, refer to 
Chapter 11 of this manual. 


The report produced by error logging can contain itemized error 
statistics with optional summary information, or it can contain only 
the summary information. Additionally, the system manager can select 
the time frame that the report is to encompass and can indicate that 
the report is to include only memory parity errors or device errors. 
Further, if a report on device errors is desired, the device type, 
unit, or volume for which the report is desired can be specified. 


Figure 8-1 provides a sample report for a device error. Figure 8-2 
provides a sample of summary information. All numbers followed by a 
period (.) are decimal values. All others are octal. Appendix C 
contains sample reports for various types of errors. 
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RSX 411 SYSTEM ERROR REPORT COMPILED AT 20RAUG@75 15246242 PAGE 1, 


HK HK IHRE KREGER EME EEK MEEKER KR ARE 
ERROR LOGGING SYSTEM STARTED 

AT 12"AUGe75 10313245 

Be I He HT ee KKK RK KEKE EKEEEKRRKEKERE 


BIGGS IOI IOI IOI IO OI III I IIIS III IOI IOI Ot 
TAPE HARDWARE ERRUR 

LOGGED AT {2"AUG"75 109214354 ERROR NUMBER io 
BORIC IGRI IOI IO III IIIS IO IOI IIT 


TAPE PARAMETERS 


UNTT NAME vT1 

VOLUME LABEL 

VOLUME OWNER UIC it 

DEVICE TYPE TUS6 UNI T=1 CONTROULLER@p 
TAPE REGISTERS AT ERROR TIME 

TCST 204037 SELECTION ERROR 

TCCM 12470e 

TCWC 177400 

TCBA 113534 

TCOT 102772 


ERROR DIAGNOSIS 
RECOVEREV 
SELECTION ERROR 


RETRIES PERFORMED B. 
USER TASK PARAMETERS 
TASK NAME Fi1lACP 
TASK UIC 22 
PHYSICAL START ADORESS 102202 
USER FUNCTION REQUESTED READ (1060) 
FUNCTION INTERPRETED FROM REGISTERS READ BLOCK NUMBER FORWARD 
PHYSICAL BUFFER ADDRESS START 115534 
TRANSFER SIZE IN BYTES 100% 
LOGICAL BLOCK NUMBER AT I0 GO 15 
COUNT OF ID IN PROGRESS le 
COUNT OF IO PENDING 1. 
NUMBER OF FUNCTIUNS ISSUED TO THIS UNIT 7 


VECTORS WITH ACTIVE I0 


Figure 8-l Device-Specific Error Log 
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SYSTEM ERROR REPORT SUMMARY (SYSTEM) 


COMMAND LINE USED 
LPSe/OREAKNGWNSALLALL/DETAIL 


REPORT FILE ENVIRONMENT 


SOURCE FILE SY: Ci,6) ERROK.SYS 
OUTPUT FILE LPs (200,200) ALLALL «LST 
DATE OF FIRST ENTRY 12—AUGe75 10213345 
DATE OF LAST ENTRY LTe8AUG=75 103821:01 

ENTRIES PROCESSED 19. 

ENTRIES MISSING 4. 

UNKNOWN ENTRIES ENCOUNTERED O» 

UNKNOWN DEVICES ENCOUNTEED 0. 

FIELD FORMAT ERRORS ENCOUNTERED @. 

DEVICE ERRORS PROCESSED 14. 

UNDEFINED INTERRUPTS PROCESSED Qe 

UNDF. INTR, MISSEGO DUE TO UNDF, INTR. PROCESSING Qe 

TRAPS THROUGH LOCATION g PROCESSED Qe 

DEVICE TIMFOUTS PROCESSED Be 


MEMORY MANAGEMENT ERRORS ENCOUNTERED 
SYSTEM POWER FAILS ENCOUNTERED 


SYSTEM PARITY ERRORS ENCOUNTERED 1. 
REPRODUCIBLE 
NON REPRODUCIBLE 

SYSTEM LOANS Ce 


SYSTEM ERROR REPORT SUMMARY (TAPE) 
TUS6 UNI T#1 CONTROLLER =@ 


HARD Be 
SOFT 1de 


Figure 8-2 Summary Error Log 
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' 8.1 FUNCTIONAL DESCRIPTION 


Error logging consists of two distinct functions. The first function 
is the gathering of information pertinent to the errors that occur and 
the second is error analysis and the creating of a list file. These 
functions are performed by three tasks: ERRLOG, PSE, and SYE. 


ERRLOG gathers volatile information when a device error occurs. It 
places this information in a temporary file named “ERR.TMP under’ UFD 
[1,6] on the system device or a user-specified device. To specify a 
device other than SY, type the following command. 


MCR>REA ERRLOG 4 dev: dev: is the device on which ERR.TMP is 
to be placed. 


When a report of errors is desired, the preanalyzer (PSE) and the 
analyzer (SYE) tasks are run. When PSE starts, it attempts to open 
the ERROR.TMP file that has the highest version number. If PSE cannot 
locate an ERROR.TMP file, it requests that ERRLOG close its current 
log file (ERR.TMP) and rename that file to, ERRLOG.TMP. 


When the next error occurs, ERRLOG creates a new ERR.TMP file and 
continues logging errors. The preanalyzer uses the information in 
ERROR.TMP to produce a formatted file. The default filename and UFD 
are ERROR.SYS and [1,6], respectively. However, any 
operator-specified name and UFD can be used. When the analyzer is 
run, it uses that formatted file to produce a list file as illustrated 
in Figures 8-1 and 8-2. 


ERROR.SYS remains on disk until the system manager deletes it because 
it contains information that can be reprocessed by the analyzer or 
processed by user-written tasks to provide a report with different 
content. Appendix C provides the layout of records in ERROR.SYS. 


8.2 OPERATIONAL INFORMATION 


This section provides operating procedures for the three error logging 
and analysis tasks (ERRLOG, PSE, and SYE) and for the task that 
terminates error logging (ERROFF). 


8.2.1 Running ERRLOG 


ERRLOG must be running in order for error statistics to be accumulated 
and for the raw data file to be passed to the preanalyzer (PSE), if an 
ERROR.TMP file is not ready for PSE to process. Normally, ERRLOG is 
installed during system generation. To run ERRLOG, type the following 
command to MCR and press ALTMODE. 


MCR>RUN ERRLOG 
The task responds with the following message. 


INPUT MINIMUM NUMBER OF ERRORS CAPABLE OF BEING 
LOGGED IN A 5 SECOND PERIOD "CARRIAGE RETURN." 
THIS VALUE SHOULD NOT EXCEED 5. 

IF ERROR LOGGING NOT WANTED INPUT "CONTROL Z." 
5 SECOND ERROR RATE = 


At this point, type a value in the range from 1 through 5 and press 


RETURN. The value indicates the number of 72-word nodes to be 
assigned permanently to the error log task. The number of nodes 
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allocated determines the minimum number of errors that can be _ logged 
by ERRLOG without a disk write. 


Errors can occur more rapidly than they can be handled by ERRLOG. In 
this case, the summary report contains an entry under the heading 
NUMBER OF ERRORS MISSED. This entry indicates the number of errors 
that were not logged due to insufficient node _ space. Because’ the 
device-specific reports provide sequential numbers for errors, the 
user can determine at which point errors occurred but were not logged. 


If a large amount of node space is allocated, it may adversely affect 
the ability of other tasks to acquire enough dynamic memory to run. 
The number of nodes required is determined by the system manager and 
varies from installation to installation. 


8.2.1.1 Abnormal Termination of ERRLOG ~- The ERRLOG task terminates 
automatically in three cases: 


1. When the desired number of nodes cannot be obtained, 
2. If the error logging device used by ERRLOG becomes full, 


3. If an error occurs when writing to the logging device. 


NOTE 


For procedures to terminate error 
logging normally, see Section 8.3. 


The ERRLOG task terminates at task startup when the task cannot obtain 
the number of nodes specified by the user. When this situation 
occurs, the following message is printed on the console. 


"ERRLOG" TASK FAILED TO PICK LARGE ENOUGH ERROR LOG 
NODE BUFFER. "ERRLOG" TASK TERMINATED. IF YOU WANT 
TO TRY AGAIN EXECUTE THE FOLLOWING SEQUENCE. 


RUN ERRLOG 


To attempt to run ERRLOG again, type the request to run ERRLOG again. 
When the request for the number of nodes is printed respond with a 
smaller number to 5 SECOND ERROR RATE = . 


The second case that causes ERRLOG to terminate is when the error 
logging device becomes full. The following message is printed on the 
console. 


ERROR LOGGING DEVICE device and unit number FULL. "ERRLOG" 
TASK TERMINATED. IF YOU WISH TO CONTINUE LOGGING ERRORS 
EXECUTE THE FOLLOWING SEQUENCE. 


REA ERRLOG 4 device and unit number 
RUN ERRLOG 


The REA command is detailed in the RSX-11D User’s Guide. 


Prior to reassigning the logging device, the new device to which it is 
to be reassigned must be given a UFD of [1,6] if it does not have one 
already. The UFD must have the following access’ rights 
[RWED,RWED,RWED,RWED]. 
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Type the following command to place the UFD on the disk. 
UFD dev: [1,6] /PRO=[RWED, RWED, RWED, RWED] 
The UFD command is detailed in the RSX-11D User's Guide. 


After creating the UFD, type the sequence provided in the _ console 
printout. 


It is suggested that the entire volume be cleared of old files using 
PIP and VFY (verify). PIP and VFY are described in the RSX-11l Utilities 
Procedures Manual. 


The third case in which ERRLOG terminates occurs if an error occurs 
while trying to write to the logging device. The following 
information is printed on the console. 


ERROR - xx ON ERROR LOGGING DEVICE device name 
"ERRLOG" TASK EXITING. 

TASK “ERRLOG" TERMINATED 

VIA “EXIT” WITH PENDING I/O 


xx is the standard system code as defined in the IAS/RSX-11D Device 
Handlers Reference Manual. If MO is’ loaded additional error 
information is printed on the terminal. If it is desirable to 
continue error logging, reassign the logging device. 


8.2.2 Running PSE 
The function of the preanalyzer, PSE, is to format the raw data 
collected by ERRLOG into a file to be processed by SYE. In order to 
run PSE, PSE must be installed, and the user must be operating under a 
privileged UIC. In addition, if no ERROR.TMP file is available for 
PSE to process, the ERRLOG task must be running. ERRLOG can rename 
the ERR.TMP file and pass it to PSE. 
Use the following command to install PSE. 

MCR>INS [11,1] PSE 


To initiate PSE after it has been installed, type the following 
command to MCR. 


MCR>PSE 


The preanalyzer responds with the prompt PSE> and waits for the user 
to type a command line. The format of the PSE command line follows. 


OUTDEV: [ufd] file.ext=indev: 
The output file specification is a standard RSX-11D specification. 
The input file specification consists only of the input device 
specification. The file name is always ERROR.TMP and it is under 


[1,6]. The name is assigned by ERRLOG. 


The following defaults are used for omitted portions of the file 
specifications. 


outdev defaults to SY: 

ufd defaults to [1,6] 
file.ext defaults to ERROR.SYS 
indev defaults to SY: 
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If the default values are to be used, press RETURN in response to’ the 
PSE prompt. When PSE prompts again, type CTRL Z to return to MCR. 


8.2.3 Running SYE 


The analyzer produces an error report in the form of a printed listing 
or a listing file. 


Before SYE can run, the user must be operating at a= privileged 
terminal and SYE must be installed. Type the following command to 
install SYE. 


MCR>INS [11,1]SYE 
Once SYE is installed, type the following command to run it. 
MCR>SYE 


The analyzer responds with the following prompt SYE> and waits for the 
user to type a command line. The format of the SYE command line 
follows. 


outdev: [ufd] =index: [ufd] file.ext/switchl.../switchn 


The output filename corresponds to the values specified for xxx and 
yyy for the /BR: switch described below. The file type is LST. The 
output filename and type should not be included in the command line. 


The input file specification is a standard RSX-11D file specification. 
The input device, UFD, filename, and extension must be identical with 
the output file specification used when running PSE. It is the output 
of PSE that SYE analyzes. 


The following switches can be used as part of the input file 
specification. 


/BR:xxxyyy is the breakout switch that determines what 
information is to be included in the report. 


xxx can have one of the following values: 


ALL indicates that error statistics for all 
disk, magnetic tape, and DECtape units 
are to be included. 


DEV indicates that only device errors are to 
be itemized in the report; that is, no 
memory parity errors are to be included. 


SYS indicates that only memory parity errors 
are to be included in the report. 


DSK indicates that error statistics for all 
disk units are to be included. 


MAG indicates that error statistics for all 
tape devices, both magnetic tape and 
DECtape, are to be included. 


ALL is the default value for xxx. 


/ID:name 


/DV:devn 


/BG: time :date 


/ED: time:date 
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yyy can have one of the following values: 


ALL indicates that both the device-specific 
and the summary information is to be 
included in the report. 


SUM indicates that only the summary 
information is to be included in the 
report. 


DSK indicates that only disk errors are to be 
included in the summary report. 


MAG indicates that only magnetic tape errors 
are to be included in the summary report. 


SUM is the default for yyy. 


The output filename is formed from the xxxyyy 
portion of the /BR- switch. The output file 
type is .LST. 


indicates that the report of errors is to 
contain only those errors that occurred while a 
specified volume is mounted. The value name 
provides the volume identification. 


The volume can be mounted using the /OVE switch 
if the volume identification is not known. The 
volume information printed on the console gives 
the volume identification once the device is 
mounted. 


indicates that the report is to contain only 
those errors that occur on a specified device 
type or on a specified unit. For example, if 
devn is specified as DK, error statistics for 
all RK@#@3 or RK®@5 units are provided. If devn 
is specified as DKl, error statistics for RK#3 
or RK#@5 unit 1 are provided. 


indicates that only those errors that occur 
after the specified time and date are to be 
included in the report. The format of the time 
and date specification follows. 


hh:mm:ss:dd:mmm:yy 


All numbers are decimal and all six fields must 
be specified. 


indicates that only those errors that occurred 
on or before the specified time and date are to 
be included in the report. Time and date have 
the same format as in the /BG switch. 
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/DE indicates that a more detailed report than that 
produced using the defaults is desired. When 
/DE is specified additional information is 
included if it is available: 
e Device error register bit description 


e Task and function that caused the entry 
to be logged 


e Statistical information about the device 


e Information relating to concurrent 
activity on the UNIBUS 


The default is NODE or -DE. 


See Appendix A for examples of the report when 
/DE is specified. 


/-SU indicates that the summary report is not to be 
produced. The default is /SU. 


The following are the default values for the SYE command string. 


SY#: [user uic]ALLSUM.LST=SY@: [1,6] ERROR.SYS/BR: ALLSUM/NODE/SU 


8.2.4 Terminatin Error Logging-—Use the following procedures to 
terminate the error logging task (ERRLOG) in an orderly fashion. 
MCR>INS [11,1] ERROFF 


MCR>RUN ERROFF 


One of two messages is printed on the terminal when. ERROFF has 
terminated error logging. The following message iS printed to 
indicate that ERROFF executed successfully. 


ERRLOG TASK TERMINATED 


The following message is printed to indicate that ERRLOG was not 
active, and therefore, was not terminated. 


ERRLOG TASK NOT ACTIVE 
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8.3 ERROR MESSAGES 


Both the preanalyzer (PSE) and the analyzer (SYE) iSsue error messages 
to inform the user of operational difficulties. 


8.3.1 PSE Error Messages 
After each error message, PSE prompts again for a new command line. 
COMMAND STRING PARSE ERROR 
A syntax or semantic error was encountered while examining the 
input command string to PSE. PSE prompts again for a new command 
line. 
Type a corrected version of the command line. 


DELETE ERROR 


After the preanalyzer processed the input file ERROR.TMP, it was 
unable to delete it. 


Attempt to delete the file using PIP. 
INPUT FILE ERROR 


An error was encountered while trying to open or obtain data from 
the input file ERROR.TMP. ERROR.TMP is closed, processing is 
terminated, and the input file is not deleted. 


PSE prompts again for a new command string. If this fails, 
delete the file. 


NO ERROR FILES FROM SYSTEM 


The preanalyzer is unable to locate a file named ERROR.TMP. This 
message can be caused by one of the following situations. 


1. No errors have occurred. Therefore ERRLOG has no raw data 
file to pass to PSE. 


2. ERRLOG is not running and, therefore, cannot, rename’ the 
ERR.TMP file to ERROR.TMP and pass it to PSE. 


3. ERRLOG is not writing to the specified device. Check the LUN 
assignment of ERRLOG. The logging device is assigned to LUN 


If the cause of the message is that ERRLOG is not running, follow 
the procedures in Section 2.2.1 to run the task. 


If the cause of the message is that the ERROR.TMP file resides on 
a device other than the one specified, use the device assiaqned to 
LUN 4 of ERRLOG as the indev for the PSE command line. 
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OUTPUT FILE ERROR 
An error was encountered while working with the PSE output file. 
Both the input and output files are closed. ERROR.TMP is not 
deleted. : 
Try to rerun PSE. 

PREANALYZER OUTPUT DEVICE FULL 


The output device became full while PSE was writing data to _ the 
output file. Both the input and output files are closed. 
ERROR.TMP is not deleted. 
Rerun PSE using a different output volume. 

UNABLE TO CLOSE INPUT FILE 


PSE is unable to close the file ERROR.TMP. The file is not 
deleted. File processing is terminated. 


Use PIP to delete the file. 
UNABLE TO CLOSE OUTPUT FILE 
PSE is unable to close the output file. 


Rerun PSE or use PIP to delete the file. 


8.3.2 SYE Error Messages 


SYE--COMMAND STRING ERROR 
portion of the string in error 


The format convention within a particular portion of the command 
string is violated. No files remain open. SYE issues a prompt. 


Correct the error and type the command. 


SYE--COMMAND STRING ERROR 
ERROR NUMBER n 


The command string interpreter detects an error while attempting 
to get a command line. nis a CSI error code. Refer to the 


IAS/RSX-11 I/0 Operations Reference Manual to determine the 
meaning of n. No files remain open. SYE issues a prompt. 
Correct the error and type the command. 


SYE--COMMAND STRING SYNTAX ERROR 
command string typed 


The proper format was not used in the command string. No files 
are open. SYE issues a prompt. 


Type the corrected command. 
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SYE--DEVICE ERROR INPUT FILE 
FATAL ERROR - n 


SYE was attempting to obtain further information from the input 
file but could not get the next record. nis an FCS error code. 


Refer to the IAS/RSX-11 I/O Operations Reference Manual to 


determine the meaning of n. 


Both the input and output files are closed. SYE issues a prompt 
for the next command. 


SYE--DEVICE ERROR OUTPUT FILE 
FATAL ERROR - n 


SYE was unable to write information in the output file. nis an 


FCS error code. Refer to the IAS/RSX-11 I/O Operations Reference 


Manual to determine the meaning of n. 


Both the input and output files are closed. SYE issues a prompt 
for the next command. 


SYE--~ILLEGAL BREAKOUT SWITCH 
/BR:xxxyyy 


SYE issues this message when the operator attempts to request a 
breakout of the input file that is not legal. No files remain 
open. SYE issus a prompt for another command. 


Retype the command with a correct use of /BR:. 


SYE-- OPEN FAILURE ON INPUT FILE 
FATAL ERROR - n 


SYE was unable to open the input file. No files remain open. n 


is an FCS error code. Refer to the IAS/RSX-11 I/O Operations 


Reference Manual to determine the meaning of n. 


SYE--OPEN FAILURE ON OUTPUT FILE 
FATAL ERROR - n 


SYE was unable to open the output file. No files remain open. n 
is an FCS error code. Refer to the IAS/RSX-11 I/O Operations 
Reference Manual to determine the meaning of n. 


SYE--n. PAGES 
text 


This message does not indicate an error; rather, it indicates 
the number of pages (n) in the finished report. The value "text" 
indicates the filename for future reference. 


SYE--SUMMARY TABLE OVERFLOW 
REPORT CONTINUES WITHOUT SUMMARIES 


Summary table overflow occurred because more devices’ received 
errors than the analyzer is built to handle. 


Use the breakout switches to reduce the number of devices 
included in the summary. 


CHAPTER 9 


SYSTEM MANAGEMENT NOTES 


This chapter contains information that can be used to optimize system 
performance and to alter certain system defaults. 


9.1 ANCILLARY CONTROL PROCESSORS AND THEIR USE 


An ancillary control processor (ACP) is a file processing task that 
interfaces between a user task and FCS on the one hand and a device 
handler on the other. The device handler performs basic operations, 
such as read and write, without aid of an ACP. However, file 
processing functions, such as create, delete, and access, are 
performed by an ACP task associated with the device. Not all devices 
have ancillary control processors associated with them. 


The ancillary control processor to be associated with a device is 
specified either explicitly or by default during system generation as 
a Parameter in the DEV directive. RSX-11D supplies three ACPs: 


F11ACP for Files-1l devices (disk and DECtape), 
MTAACP for magnetic tape handling, 
DTAACP for installations that require significant amounts 


of DECtape processing. 


F11ACP and MTAACP are the default ACPs for Files-1ll devices’ and 
Magnetic tape, respectively. DTAACP is used for DECtape instead of 
FLIACP if so specified during system generation. If desired, a 
user-written ACP can be associated with any device during system 
generation. A user-written ACP can be specified instead of a standard 
RSX-11D ACP or to perform special functions on a device that does not 
have a standard ACP associated with it. Only one ACP can be 
associated with each device. 


System generation establishes the default ACP to be associated with a 
device when it is mounted. However, use of the /ACP switch with the 
MOUNT command can override the default ACP for a device. 


All ACPs must have a 6-character task name that ends with the letters 
ACP. ACPs must be installed either during system generation or by 
means of the INSTALL command to MCR. 
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9.1.1 Files-11 ACPs 


Two versions of FI11lACP are supplied with RSX-11D: FCP.TSK and 
BIGFCP.TSK. They appear under different filenames in UFD [11,1]. 


The file named FCP.TSK is a minimum size, heavily overlaid version 
occupying approximately 2.4K words of memory. It is recommended for 
small systems with limited space and where high file processing 
throughput is not essential. 


The file named BIGFCP.TSK is minimally overlaid and has additional 
buffer space. It incurs almost no overlay switching during normal 
operations and provides some optimization of disk accesses due to its 
additional buffer. BIGFCP.TSK occupies approximately 4.5K words of 
memory. 


Both FCP.TSK and BIGFCP.TSK are built with a task name of F1I1ACP. 


The file DTAACP.TSK is a version of FII1ACP that is optimized for 
DECtape operation. It is heavily overlaid, but has the additional 
buffer. It occupies approximately 2.6K words of memory. DTAACP.TSK 
is built with a task name of DTAACP. 


In large systems with a heavy file processing requirement (for 
example, a multiuser program development system), multiple versions of 
an ACP can be installed to achieve some parallelism in file 
processing. Each ACP task processes all functions in a strictly 
sequential manner. Having two versions of FI11ACP installed in the 
system allows each version to service requests for a different set of 
devices. 


For example, in a system with two RP@4 drives and two RK#5 drives, the 
system manager could specify FI1ACP as the ACP for the RP@4 drives and 
RKAACP as the ACP for the RK#5 drives during system generation. By 
installing BIGFCP twice, the system manager could provide each device 
type with its own ACP. File processing then occurs concurrently on 
RP#@4s and RK#5s. In addition, the extra buffer space available in the 
two copies of the file processor, whether it be FCP or BIGFCP, saves a 
certain percentage of disk accesses. 


An installation that does a significant amount of Files-1ll DECtape I/O 
in a multiuser environment should consider using DTAACP for DECtape 
and FI11lACP for disks. Use of DTAACP ensures that the processing of 
DECtapes does not interfere with disk file processing. 


9.1.2 Magnetic Tape ACP 


The magnetic tape ACP is named MTAACP and provides support of ANSI 
Magnetic tape file structures. Unlike FI1ACP, it is both nonfixable 
and checkpointable. 


MTAACP does not need to be fixed in memory for performance’ reasons. 
When a magnetic tape is mounted, MTAACP is loaded into memory if it is 
not already there. It does not exit from the system after it services 
a request; the only time MTAACP exits is when no magnetic tape 
volumes are mounted and no outstanding I/O requests remain to be 
serviced. The result is that once a magnetic tape volume is mounted, 
which requires use of MTAACP, the ACP task is effectively locked in 
memory. 
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MTAACP is built with a priority of 200. Because it is checkpointable, 
a deadlock can occur on either a normal I/O request or I/O rundown in 
the following situation: 


1. A task with a higher priority than MTAACP causes it to be 
checkpoeinted, 


2. That task then needs the services of MTAACP but insufficient 
memory remains to load MTAACP. 


9.1.2.1 File and Record Attribute Support under MTAACP 


The ANSI magnetic tape file system (MTAACP) supports the FCS record 
types and attributes with the exception of symbolic offset FD.BLK in 
the FDB. FD.BLK is set unconditionally to indicate that records 
cannot cross. block boundaries. The result is that, for files 
containing variable-length records, the block length (that is, buffer 
size) must be equal to or greater than the maximum record size plus 
four. Therefore, the default block size of 512 bytes yields a maximum 
variable-length record size of 5988 bytes. 


MTAACP does not support the FCS file characteristics (attributes) in 
that it treats all files as noncontiguous. If a file on magnetic tape 
is to be contiguous on disk or DECtape, the following steps must _ be 
performed using PIP: 


1. Transfer the file from magnetic tape to either a 
Files-ll disk or DECtape to cause FCS to determine the 
real size of the file in blocks. 


2. Transfer the file from the disk or DECtape to the 
desired device using the /CO switch in the output file 
specification to PIP. 


9.2 /LRU SWITCH ON INITVOL AND MOUNT 


Another optimization feature is the /LRU switch that can be specified 
on the INITVOL and MOUNT commands to MCR. All versions of FI11ACP 
Maintain in memory a list of recently referred to directories. Each 
mounted volume has an associated list. If a directory is present in 
the list, the overhead involved in gaining access to the directory is 
almost completely eliminated. Entries in the list are replaced on a 
least-frequently-used basis. 


The /LRU switch specifies the number of entries that are to be 
retained in the list for a particular volume while it is mounted. The 
INITVOL and MOUNT default value is three, which is an appropriate 
value for a single-user volume. In general, the /LRU value should be 
a few units greater than the expected number of concurrent users of 
the volume. 


9.3 TAILORING F11ACP 


The file primitives (F1l1ACP) in RSX-11D Version 6B can be tailored to 
suit the needs of a particular installation in several ways. All 
involve balancing certain size/performance tradeoffs. 


SYSTEM MANAGEMENT NOTES 


9.3.1 Overlay Structure 


The file primitives are almost always run overlayed. Two task builder 
command files and overlay description files are provided for two 
different overlay structures. The smallest FCP (FCP.CMD and FCP.ODL) 
occupies roughly 2.4K words of memory. It is structured with -one 
overlay for each FCP function and is recommended for small systems 
where space is limited and high file processing throughput is not 
important. A larger overlay structure is also provided (BIGFCP.CMD 
and BIGFCP.ODL). It incurs almost no overlay switching during normal 
file processing; overlays are used only for errors and exceptions. 


9.3.2 Additional Directory Buffer 


A separate buffer for directories can be allocated in FCP with either 
overlay structure. The presence of this buffer speeds up operation 
when repeated references are made to the same directory; for example, 
such as file purges and wild card operations. The directory buffer is 
allocated by including the following statement in the task builder 
command file to build FCP: 


EXTSCT=SSBUF1:1886 


9.3.3 Extended Directory Buffer 


If a significant percentage of the directories used in a system are 
large (greater than 3@ entries), an additional performance improvement 
can be realized by increasing the size of the directory buffer. Then 
fewer physical disk accesses are necessary to search a large 
directory. The directory buffer should be extended in units of one 
block, expressed in multiples of 1808 bytes (octal). For example, the 
following task builder statement: 


EXTSCT=SSBUF3: 2609 


adds two blocks to the directory buffer, allowing the file system to 
handle directories in three block units. Extending the directory 
buffer can be done only if a separate directory buffer has also been 
allocated as described above in Section 9.3.2. 


9.3.4 Additional Storage for FCB’s 


The file primitives use one file control block (FCB) for each file 
that is currently open in the system. In addition, each directory LRU 
list entry occupies one FCB, and one FCB is used for each mounted 
volume for the index file. Therefore, the total number of FCBs 
allocated in the system is the sum of the number of mounted volumes 
Plus the sum of all mounted volumes” LRU limits plus the total number 
of open files. Each FCB is 21 words in length. FCBS are normally 
allocated in the system node pool, where they occupy 24 words apiece. 
Pool space is allocated in 8-word units. Clearly, in a large 
multiuser system FCBs can take up a substantial amount of pool space 
(several K, in fact). The system manager can allocate space for FCBs 


within the task body of the file primitives with a task builder 
command of the following form: 


EXTSCT=SSFRE1: 2008 
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The space is expressed in octal bytes. Each unit of 1908 has _ space 
for approximately 21 FCBs. FCP allocates FCBs out of this area until 
it is full; it then uses the system node pool. 


NOTE 


In the system as distributed, FCP has no 
internal FCB space and BIGFCP has 2806 
bytes of internal space. 


9.4 REASSIGNMENT OF TASK BUILDING AND CROSS REFERENCE LUNS 


Both the Task Builder and the cross reference task (CRF) use dynamic 
memory for symbol processing. System performance when TKB or CRF 
execute can be enhanced given appropriate resources. 


TKB uses LUN 8 for its dynamic workfile, while CRF uses LUN 7. In_ the 
released system, these logical unit numbers are assigned to the device 
on which the TKB and CRF tasks reside. Both tasks are overlaid so 
that, in any configuration, it may be advantageous to reassign the 
logical unit numbers to another device. 


Example: 


MCR>REA CRF... 7 DPl: 


9.5 COLUMN WIDTH FOR CRF OUTPUT 
The released CRF is built with 132-column line output. 


The column width for printed output from CRF can be altered by 
rebuilding the cross reference task. The task build command file for 
CRF resides under UFD [11,32] on the auxiliary distribution medium and 
is called CRFBLD.CMD. It contains the following line: 


EXTSCT=$$RCBO: 264 


This line establishes a 132-column line width. Omission of this 
option by inserting a semicolon (;) before the line causes’ the 
building of a CRF with an 88-column line output. 


9.6 CHANGING TASK BUILDER DEFAULTS 


The RSX-11D Task Builder contains default values that are used when 
switches and options are omitted from a command to the Task Builder. 
These switches and options and their defaults are detailed in the 
RSX-11D Task Builder Reference Manual. 


Some installations may prefer a different set of defaults in TKB: in 
particular, a default of "task unaccountable" may be desirable. 
Defaults can be changed by rebuilding the Task Builder with a global 
patch applied. 
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To. apply the patch, three files must be obtained from UFD [11,11] of 
the auxiliary distribution medium: TKBBLD.CMD, TKBODL.ODL, and 
TKB.OLB. These files are the build command file, the 
overlay-descriptor file, and the relocatable object library of all TKB 
modules, respectively. 


The list below provides the available task image attributes and the 
bit pattern required to set them. The default in the released version 
of the Task Builder was achieved by initializing the task image with 
SWSFX!SWSFP. 


SWSCP==180008 
SWSFP==8 400098 
SWSDA==6 26008 
SWS PI==681606 
SWS PR==9 00408 
SWSTR==880 208 
SWSNH==618008 


TASK CHECKPOINTABLE (9=YES) 

TASK USES FLOATING POINT (1=YES) 

TASK DEBUGGING AID SPECIFIED (1=YES) 

PIC OUTPUT (1=YES) (ALSO APPLIES TO STB) 
TASK IS PRIVILEGED (1=YES) 

SET TRACE BIT IN PS (1=YES) 

BUILD TASK IMAGE WITHOUT HEADER (1=YES) 


me se TO MO NO TO TO 


SWS FX==094000 
SWSAB==8 996290 
SWSDS==8980190 
SWSMU==8 60002 
SWSTA==808001 


TASK IS FIXABLE (9=YES) 

TASK ABORTABLE (@=YES) 

TASK DISABLABLE (9=YES) 

+++916 MULTI-USER SWITCH (1=YES) 
+++916 ACCOUNTING SWITCH (1=YES) 


=e =e SO 6M UNO 


Referring to the list above, the defaults produce a pattern of 44690. 


To build a TKB that has these defaults (not fixable, floating point, 
etc.) plus the task accountable default, the following pattern is 
required: 


SWSFX!SWSFP!SWSTA = 44061 


Having calculated the required default bit pattern from the list 
above, edit the file [11,11]TKBBLD.CMD to insert the option in the 
following form: 


GBLPAT=P110VR: $MRFLG+134:value 


value = the requisite bit pattern for the desired defaults; for 
example, 44881 is used to produce the standard released 
defaults with the addition of the task accountable 
default. 


CHAPTER 10 


EXECUTIVE DEBUGGING AIDS 


RSX-11D provides two debugging aids that can be incorporated into the 
Executive: 


1. Executive ODT 


2. Executive trace. 


18.1 EXECUTIVE ODT 
A simplified version of ODT can be task built into the Executive if 
needed for the debugging of user-~initiated modifications to the 
Executive. This version of ODT can perform the following functions: 
1. Set and remove breakboints, 
2. Examine the content of a location and modify the content, 
3. Search for bit patterns. 
Executive ODT operates only in Kernel space. For example, breakpoints 


can be set only in Kernel space and only Kernel locations can be 
examined. 


18.1.1 Building ODT into the Executive 


Use the following procedures to build ODT into the Executive and 
generate the new system. 


1. Log onto the system under [1,l]. 


2. In the file [11,15]TKB15.CMD, locate the line [11,15]NODT and 
change it to [11,15]ODT. 


3. Rebuild the Executive using [11,15]TKD15.CMD as in the 
following command. 


TKB> [11,15] TKB15 


4. Rebuild the bootstraps using the command file 
[11,17]BOOTSBLD.CMD. 


5. Perform a system generation using an appropriate command 
file, examples of which are distributed under UFD[11,17]. 


After phase 1 of system generation when the disk is booted, 
the following message is printed at the terminal. 
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EXECUTIVE DEBUGGING AIDS 
S/T RSX ODT V7.@9 
* 


6. Press CTRL/C to initiate phase 2 of system generation. 


7. Follow the formal procedures for saving the system at the end 
of phase 2 as described in the RSX-11D System Generation 
Reference Manual. 


18.1.2 Using Executive ODT 


NOTE 


It is not possible to use both Executive 
ODT and user task ODT at the same time. 


Once the system generation is completed, the ODT message (S/T RSX EXEC 
ODT V.97) is printed at the terminal each time the system is 
bootstrapped or a power failure recovery occurs. When the message is 
printed, it is followed by the ODT prompt, which is an asterisk (*). 
The user can perform either of the following in response to the ODT 
prompt: 


l. . Interact with ODT, 
2. Press CTRL/C to allow normal system operation. 


Before CTRL C is depressed, the user can issue the commands to set or 
remove breakpoints, examine or modify the contents of locations, or 
search for bit patterns. These commands are detailed in the 


IAS/RSX-11 ODT Manual. Examples are provided below. 


Once the necessary initial set-up for Executive ODT is complete, press 
CTRL C to obtain MCR. Normal RSX-11D operation begins and _ continues 
until an instruction in a breakpoint location is executed. Then ODT 
prompts with an asterisk. At that point, any of the commands to ODT 
named in Section 1@.1 can be used. When ready to continue normal 
RSX-11D operation, use the P command as described in the IAS/RSX-11 
ODT Manual. 


18.1.2.1 Setting a _Breakpoint - In order to set a breakpoint, the 
user needs a listing of [111,15]EXEC.MAP and a listing of each module 
in which a _ breakpoint is to be set. This is similar to the process 
used with task ODT. The following is an example of setting a 
breakpoint at location 3612. 


*3612;0B The asterisk (*) is the ODT prompt. 


18.1.2.2 Examining and Modifying a Location - The following command 
causes ODT to print the contents of location 3716 on the terminal and 


allows the user to modify the content. Location 3716 contains 998881; 
the user types 4 to indicate that ODT is to change the content at the 
location to #990004. 


*3716/000081 4 


19.1. 
use oO 


EXECUTIVE DEBUGGING AIDS 


2.3 Sample Use of ODT - The following example illustrates the 


£f Executive ODT. 


S/T RSX ODT v7.90 
*3612;0B 
*"C 

RSX-11D V6.2 
MCR>MOU DK@:/OVR 
MCR>HEL [1,1] 
MCR>INS TEST 
MCR>RUN TEST(S) 
BO:3612 


*3646;1B 
*$1/666542 
ial 

MCR> 


;SYSTEM IS BOOTED 

;SET INITIAL BREAKPOINT 

;PRESS CTRL/C 

;NORMAL SYSTEM OPERATION COMMENCES 
;MOUNT SYSTEM DISK 

;LOG ONTO SYSTEM 

;INSTALL TASK NAMED TEST 

;RUN TEST AND DEPRESS ALTMODE 
;TEST CAUSED EXECUTIVE TO EXECUTE 
;INSTRUCTION AT LOCATION 3612 
;SET ANOTHER BREAKPOINT 

;EXAMINE CONTENTS OF REGISTER 1 
;CONTINUE RSX-11D OPERATION 


18.2 EXECUTIVE TRACE 


The Executive trace facility is part of the resident Executive and is 


useful for tracing ISRs. 


The Executive trace allows the user to trace 


ranges within an ISR and to halt at specified locations. 


19.2.1 Building Trace into the Executive 


The resident Executive in the distributed system does not contain the 


trace 


facility. To include 


trace, the Executive must be rebuilt 


according to the steps below. 


l. 
2. 


Put UFD [11,15] on disk and set it as the current UIC. 


Use FLX to transfer the [11,15] files from the distribution 
binary medium. 


Repeat steps 1 and 2 for UFD [11,17]. 


Modify [11,15]TKB15.CMD by changing the line [11,15]NTRACE to 
[11,15] TRACE. 


Task Build the Executive using TKB15.CMD and task build the 
bootstraps using [11,17]BOOTSBLD.CMD. 


Change the system generation phase 1 command file to reflect 
the increased size of the Executive. 


Generate the new system. 


EXECUTIVE DEBUGGING AIDS 


19.2.2 Using Executive Trace 


Once the system generation is completed, use the steps listed below to. 
cause trace to execute. 


1. Find the address of the global symbol .DBTRA in the EXEC.STB 
listing which can be obtained from [11,15] EXEC.MAP. 


2. Using the OPE command to MCR, set up to four trace ranges in 
the four word-pairs starting at location .DBTRA-38. Addresses 
are in Kernel virtual space. The following is an example of 
using the OPE command to specify one range. 


MCR>OPE .dbtra-36/KNL Type in actual address of 

OOT166 600008 /4146 - DBTRA-39 

601162 @88000/4147 

961164 §88608/(S) Depress ALTMODE to return 
to MCR. 


Alternatively, set console switch 9 up to trace the entire 
ISR. 


3. If desired, set up to five halt addresses in the four 
word-pairs starting at .DBTRA-4@ or set one halt address in 
console switches 15 through 1. Use the OPE command as in step 
2 to set the halt addresses. 


4. Change Kernel address 14 to contain the address of .DBTRA as 
follows: ; 
MCR>OPE 14/KNL 
608014 nnnnnn/xxxxxx nnnnnn = present contents. 
of 14. 
xxxxxx = address of .DBTRA 
as specified by 
the user. 


5. Set the T-bit (bit 4) in the second word of the interrupt 
vector for the interrupt service routine to be traced; for 
example in the DP ISR, set bit 4 in vector 254. 


The trace printed on CL is essentially in the same format as that for 
the task trace package; only the relative PC is omitted. Refer to 


the task trace chapter of the IAS/RSX-11 ODT Manual. 


If one of the reguested halt addresses is encountered, the computer 
halts with the requested address in the data lights. Execution can be 
resumed by pressing CONT. 
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CHAPTER 11 


PARITY SUPPORT 


Under RSX-11D, the handling of errors is divided into three 
categories: 


1. Main memory parity support, 
2. Cache memory parity support on a PDP-11/78, 
3. Additional PDP-11/7@ hardware error support. 


For a description of cache memory, refer to the PDP-11/76 Processor 
Handbook. 


11.1 MAIN MEMORY PARITY SUPPORT 


Main memory parity errors are an indication of a memory malfunction. 
When a parity error occurs, it causes a trap to the RSX-11D Executive. 
The Executive determines whether the error was fatal (nonrecoverable) 
or not and then takes appropriate action. In the PDP-11/4@, 11/45, 
and 11/5@, all parity errors are fatal and are treated as main memory 
errors. 


The PDP-11/78 hardware recognizes two types of main memory errors: 
address and data. The Executive handles both types of errors 
identically, although errors are logged as being one of the two types; 
refer to Chapter 8 for information on the logging of errors. 


When a fatal main memory parity error occurs, the Executive terminates 
the task executing where the error occurred unless that task has a 
hardware priority greater than three. The aborted task remains in 
Memory and no further access to or execution of the task is allowed. 
Locking the task in memory also makes the entire area of memory 
allocated to the task inaccessible to the system or other tasks. When 
the Executive terminates a task, an error message is printed on CO and 
on the terminal that initiated the task. 
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If the Executive encounters any of the following conditions, it halts 
system operation; that is, a system crash occurs: 


1. The hardware priority of the task executing where the error 
occurred is greater than three, 


2. No task is executing currently, 
3. The error occurred in Kernel mode. 


The only difference between parity handling on the PDP-11/78 and other 
PDP-1l’s is that the 11/79 provides the Executive with an indication 
of whether the error was fatal. Fatal errors are handled as described 
above. Nonfatal errors are transparent to the task executing where 
the error occurred, but are logged by the Executive as described in 
Chapter 8. 


11.2 CACHE PARITY SUPPORT (PDP-11/78 ONLY) 


Because cache contains a copy of information also maintained in main 
memory, it can recover from cache parity errors by obtaining the 
information from main memory. Fatal parity errors are never returned 
for cache. Rather, the Executive performs the following sequence: 


1. Determines the cache group in which the error occurred, 


2. Determines whether the group has exceeded the number of 
errors allowed in a l-minute period, 


3. Turns the group off if the limit has been exceeded, 
4. Logs the error. 


This process is transparent to the task using the cache group in which 
the error occurs. However, program execution speed may be affected. 


The default number of errors allowed in a l-minute period is 59 
(decimal). This number can be changed by the system manager as 
described in Section 11.4. 


The PDP-11/7@ hardware recognizes two types of cache errors: address 
and data. The Executive handles both types of errors identically, 
although errors are logged as being of the two types; refer to 
Chapter 8 for information on error logging. 
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11.3 ADDITIONAL PDP-11/78 HARDWARE ERROR SUPPORT 


The RSX-11D Executive handles three other types of hardware errors 
that the PDP-11/7@8 reports: 


Nonexistent memory, 
UNIBUS error, 


CPU/UNIBUS abort. 


11.3.1 Nonexistent Memory 


A nonexistent memory error implies that faulty mapping or a bad 
address has caused the central processing unit to refer to a 
nonexistent memory location. This type of error is treated in the 
same manner as a main memory parity error. 


11.3.2 UNIBUS Error 


A UNIBUS error occurs when bad memory is referred to during a direct 
memory access (DMA) transfer. Since the task currently executing is 
probably not the task for which the I/O is being done, the Executive 
makes no attempt to determine which task issued the I/O request or to 
locate the bad memory. The error is only logged. Some UNIBUS device 
controllers detect the memory error and report it at the end of the 
transfer, 


11.3.3 CPU/UNIBUS Abort 


The CPU/UNIBUS abort occurs when bad data is transferred during a 
non-DMA I/O transfer or ae read of UNIBUS I/O page registers. The 
Executive terminates the task currently executing because it is the 
task that issued the I/O request. The error is logged. 


11.4 SYSTEM MANAGER’S CONTROL OF PARITY HANDLING 
Two MCR functions, SET and MEM, provide the system manager with a 


means Of controlling the effects of parity error handling. Both of 
these functions are detailed in the RSX-11D User’s Guide. 
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11.4.1 SET Functions for Controlling Parity 


The SET command is used in conjunction with cache parity. It allows 
the system manager to turn cache groups on and off and to change the 
default number of errors that are allowed in a l-minute period. 


Examples: 


MCR>SET /CAC=75 This command indicates that 75 cache parity 
errors are to be allowed in a l-minute period 
before the Executive turns the group off. The 
system default is 56. 


MCR>SET /CAC=ON1 This command turns on cache group l. 
MCR>SET /CAC=OF@ This command turns off cache group @. 


The system manager can determine which groups are receiving errors’ by 
consulting the error log as described in Chapter 8. 


11.4.2 MEM Function for Freeing Memory 


The MEM command to MCR allows the system manager to free a task locked 
in memory due to main memory parity errors and to free the memory 
allocated to it. That task then can be run again; however, the 
memory can also be used for subsequent task execution and can result 
in further task terminations. 


Examples: 


MCR>MEM PROGI1 This command frees the first task 
encountered that has the name PROGI. 


MCR>MEM PROG]/TI=TT3 This command frees the task PROG] that was 
initiated from terminal 3. 


MCR>MEM PROG1/AL This command frees all locked versions of 
PROGI. 


11.5 TASK CONTROL OF PARITY HANDLING 


The user can avoid having a task terminated by the Executive when a 
parity error occurs by declaring an SST (synchronous system trap) in 
the task. SSTs are described in the RSX-11D Executive Reference 
Manual. 


APPENDIX A 


CDA SAMPLE LISTING 


RsxeilO CORE*DUMP ANALYZER V@6.2 5eOCT#76 14825 PAGE } 
CRaSH STACK 


CAUSE OF CRASH: NON*TASK LEVEL SEGMENT FAULT OR TRAP FQUR 


AFTER CRASH: PSa8¥04344 SP(K) 9001454 SP(U)#170542 
BEFORE CRASH: PC8@84456 PSs@04301 
Ra0eG13173 Ri agagegl R2s@00081 R3eG96080 R48088774 R5#812667 


SRO ae0HBB3 SR1 5200600 $R28835576 SR3e@0U088 


US ER 

I SPACE D SPACE 
POR PAR PDR PAR 
90¢406 gaeeei eegecea 000377 
COenee eeveoe 000608 087717 
280208 e02000 2000008 082437 
Ga00K0 ueceoa 280000 247733 
080086 @0v800 200000 027662 
2eG200 200000 eeeeeea 127400 
G2088E 020000 vecega 007624 
680000 680080 a0a000 oe6ene 


SUPERVISOR 


I SPACE ) SPACE 
POR PAR POR PAR 
A20008 282980 evgage geatae 
862028008 800000 0000o0 080017 
600016 @80800 000012 000217 
200014 060000 0800280 000037 
000008 200080 000000 088008 
600016 606000 000007 0086017 
6800018 8868000 800008 900008 
@80017 206880 0000028 6209000 
KERNEL 
I SPACE ) SPACE 
POR PAR PDR PAR 
077506 B08604 060917 125252 
077166 C86204 044017 125252 
600000 088000 010015 125252 
077406 G80021 @77435 125252 
4G0116 086462 030013 125252 
077466 @82602 047018 165542 
277546 001882 016011 000000 
277506 1776008 080600 686000 


A-1 


CDA SAMPLE LISTING 


Rsxei10 CORE*DUMP ANALYZER V86.2 5°0CT#76 14925 PAGE 2 
KERNEL STACK 


KERNEL STACK: 


ooigee 204216 084340 89800980 Af20026 O80008 808000 880800 260000 
e21520 BOCU8G BHH080 B8A080 AGABCA BB0GAH BB8008 880880 000008 
aeia4e OG0800 B80008 808002 ABABED B80000 800000 080000 200000 
001060 @00000 880008 800000 A22000 280090 000000 880000 200008 
001190 G@20000 820080 AQAGSS HEGA202 ABABAR AG8080 200080 980080 
821120 HO082R 808002 800008 A20000 8280222 902000 280000 2892080 
@01140 ABCOLR VGCCAS B9AGAG AHAGOH BH0008 200000 800000 6829000 
021162 860000 0980008 8080908 A200 A80208 920000 880080 200000 
001206 GA0000 G08000 BH8G08 ALGAGD 80200 200000 800000 200800 
081226 O0909@ AGABGG BOBCAB ABCAGH 280000 870000 902000 200800 
ee1246 B9G0IG B8G80R2 ABVABAR ABAOGS ABBA9G AGALEB BBH0AC 400000 
001262 4O0800Q B80002 892080 AGOBOB YABAAGAH 208000 8000028 200000 
801306 OQ20008 A280000 800028 ABAACH B20828 200080 8099000 089080 
@801320 BQCbAW SEBHAS B9A820 AGAAGA O2AG8RG A00000 260000 089080 
@41340 GACC2B O2HH2B B00800 AB2352 234112 142040 062352 B04240 
821360 060166 @A8012 840142 871102 904240 848140 800001 889480 
201406 762574 G24259 8612528 480400 261312 800400 103568 141740 
081420 150876 034040 @08002 147364 @34151 834111 1451768 147554 
801440 110254 034111 800000 15474 935266 235122 8Bevg6 204456 
201460 Q@H4301 864328 884300 1480017 813171 034300 000074 174013 


RSxe110 CORE*DUMP ANALYZER V06,2 5@0CT#76 14325 PAGE $3 
SYSTEM COMMUNICATIONS AREA 


CRASH OCCURRED AT 14324383 5e0CT#76 


eCRTSK & NULL TASK 
eFP 45X51 oPOP1187@, oMSTZE88192,8256K eCKFSZ#545, 
» SERFG#AQ0080 eCOMEFaOGO800 040088 


CHECKPOINT BITMAP? 
037500 477777) 377777) 377777) 377777) 3877777) 177777) 8377777) 877777 


SCOM DATA AREA? 


146120 145749 820001 020106 A2aneo ooaede sengae B00400 B00062 
146120 070100 177777 178801 177777 agaae2 105721 841104 200062 
146142 00017 000071 a0@044 AaBo12 ee0005 Banei2 880114 177546 
146466 COG10G B90081 ageeee ABaDee A40v00 051522 030530 42061 
146200 080454 626226 G20002 04401 960146 060146 a8eve0 ag20ee 
146220 @H8374 198108 agev22 apegee nadgee® seune@e 104760 103220 
146249 144724 600000 8200000 aga000 144724 egna00 aeeeaH eoe08e 
146262 G02000 490000 A2028 ABeAes BpABee 005111 B25367 03310 
146300 WOOBAG B20G80 H00080 aoanee 146316 seogaa ovebes 104760 
146320 144724 177777 994082 ne0602 agiee2 177600 900016 077406 
146340 @77406 877486 144642 @2008@2 270624 145100 145174 142240 
146360 14214G 142300 145970 145200 000210 poze 145600 145740 
14642¢ 196060 106320 107440 107440 111060 141960 1411720 111720 
14642¢ 101160 @f80@8 190800 AgeneY 237500 937520 evieas eoonee 
146449 00002 800017 845462 nag002 apoaegs nenasa Beedel veuSeae 
146468 GA1GSi S90081 145150 941104 Mp0000 014554 008172 eenees 


RSxell0 CORE*DUMP ANALYZER V@6,.2 5e0CT#76 14:25 PAGE 4 
ATL SCAN 
OBeeces 
ATL ADDRESS #® 145600V/106000R STD ADDRESS s 142100V/1023900R 
REQUESTOR © DBeee, LOAD ADDRESS #® @o12n208 
PARSSYDISK PRIe25A, 1/0 IN PROG&Q, I/O PENDaa, STATUSsWO TIsTT@ 
EVENT FLAGSsOfA@200 440002 MASKS#O0AGO7 BAPCBe BoOVAD aBaaa0 
TASK FLAGS! 600000 
1456200 109260 146374 142192 142300 290372 fageeo 200082 a81202 
145626 FOG016 142100 880200 A08800 00007 2400800 avevee gaeece 
14564¢ 145100 145642 145642 aga008 @u0000 270000 148654 145654 
TT eee 
ATL ADDRESS = 100266V/040460R STD ADDRESS # 141740V/102140R 
REQUESTOR = TT.ue, LOAD ADDRESS # 09150100 
PAR@GEN PRI s248, J~/O IN PROGSQO, 1/0 PENDs@, STATUS8wWoO TIsTT2 
EVENT FLAGSs@0@000 240000 MASKS8@07377 goened Beaeen Beagee 
TASK FLAGS: #080080 
1@2@26¢ 14104@ 145600 141749 144332 200370 oo000@ 900001 01501 
1080300 000016 141742 200800 240000 287377 ane020 200008 Bav0ee 
188320 145158 190322 100322 990002 027733 BnA0eS 108334 108336 
LPeees 
ATL ADDRESS © 10104fV/041249R . STD ADDRESS = 104360y/G44560R 
REQUESTOR = ,,,MFT LOAD ADDRESS & 4225600 
PARSsGEN PRI 3248, 1/0 IN PROGsO, 1/0 PENDaé, STATUSSWO TIsTT@ 
EVENT FLAGSs¢p@00@ BAataR «MASKSsHR9GG3 606401 ABeene Baanee 
TASK FLAGS? #80020 
101046 196460 190268 182368 142390 a9037a agesod avovee 202256 
121 96¢ 00016 104368 Ao8e20 AEABCB ABAe@S 896421 880000 aseear 
iviiee 14515@ 101102 161102 Avave1 141022 B00B82 101114 183114 
DK wee 
ATL ADDRESS © 106460V/046660R STD ADDRESS # 103420V/043620R 
REQUESTOR = ,,,MFT LOAD ADDRESS # @¢251000 
PARSGEN PRIa248, 1/0 IN PROGS@, 1/0 PENOa®, STATUSSWY . TIsTTQ 
EVENT FLAGSsug@Oue BaGOBe MASKSsQuages 646491 Bveven gvovras 
TASK FLAGS: o0e000 
10646¢ 19672@ 1018040 102360 142302 900370 eoeaea Bvevee AB2510 
106506 O420016 143420 @882080 AGORA AGOODS 206401 Bea0Ge AageeBe 
19652¢ 145156 106522 106522 20001 240066 820000 106534 1065354 


CDA SAMPLE LISTING 


CDA SAMPLE LISTING 


Rsxel10 CORE*DUMP ANALYZER v86.2 S#0CT*76 14:25 PAGE 6 
TASK HEADERS 


08, eee 

Sneeaee 
SEADER ADDRESS #8 98120202 ATL ADDRESS = 145600V/106000R 
H,CRiseeeeoe 
USER POR'S! 035606 @o980e0 @o0e8@ AgDeAm 400016 677406 877406 277406 
USER PAR'S? @81206 @0000@ e00009 avenee o90402 a00682 Bvivoe 177600 
P$3174e800 Pcsgee4i2 
RO80@7034 Riaii2ze62 R2sgseoao R3enge081 R4e109200 R58145600 SPsgan356 
INITIAL P$8374017 INITIAL PCsgaai00 INITIAL SPepQol1ee 
WEADER SIZEsagaea3 OSWseaaoe: §§§ NUMBER OF LUNS#6, 


LOGICAL UNIT TABLES 
# OEV WINDOW WeCTL W,VBN WeFCB F.FNUM FeFSEQ F,STAT NAC NLCK 


SY¥® 290900 
SYS 6282020 
SY6 280080 
SY@ 808000 
TIlIa 990000 
CLe 890080 


DA & GA 


HEADERS 


800900 BB0G0R A35606 880089 AOORBG 860088 B0A016 8774806 077406 
808620 077406 801205 2880000 00000 ageee8 060402 808682 2801002 
220040 177628 80003 02000 200000 200000 200402 B48602 01002 
000060 177608 1748608 00412 0807034 1120268 A0A000 800001 100280 
800100 145600 @@8356 174817 A00100 280188 882000 800080 202000 
888120 100000 800208 802481 800401 200003 920010 O80v28 200000 
800146 137665 0862900 O0AA8R2 460146 060146 000082 480088 000006 
0001690 145086 880002 145006 Aeeeegd 145206 0000008 145406 dvdbeu 
088200 BBG001 G808G0 142526 ABABED 400080 Bn0000 B0ALAv 28000 
000220 060000 C80080 800000 AGOBAR 26000820 a00002 e0080 202000 
060240 CQGG8G BOCZAG CB8HG8H ABBHGB BABCQ6 BOBECOG AKLOLAR 200KG0 
800260 PA26828B 828000 B4A82D A0A08R2 A80000 802000 8000008 200000 


TT eve 
HEADER ADDRESS @ 90150102 ATL ADDRESS = 140260V/048460R 
H,CRis9g0000 
USER POR'S: @61286 077486 925106 865106 @00216 08774806 877406 877486 
USER PAR'Ss 991593 a@g4227 @02034 402103 aga4e2 “nag602 Buieee 177600 
p§0174000 PCeGO4114 ~ 
ROeGC4010 Risaeen44 R2eg8e000 R38AG080) R49177777 RS8048048 SP8900172 
INITIAL PS#174017 INITIAL PCsage2ae INITIAL SPefAG0200 
HEADER SIZEs@goce?. DS$Waeoege1 NUMBER OF LUNS2J, 


LOGICAL UNIT TABLE! 


a 


CDA SAMPLE LISTING 


RsxyeilD CORE*DUMP ANALYZER VO6e2 5e0CT#76 14:25 PAGE 9 
Task HEADERS 


# DEV WINDOW WeCTL Ww, VBN weFCB F,FNUM F,FSEQ F,STAT NAC NLCK 


1 CcOv ageece 
2 SYA aeegaa 
3 DBB eoeaan 


HEADERS 


C2PBVG ABAEOR 861206 077406 23106 265106 980016 877406 277406 
@OUB20 677406 @815@3 864227 He2034 802195 800402 abe6a2 281002 
908040 177680 00002 @00003 feB0e1 Apaes2 BAede2 BVeBbe2 01202 
gava6e 177600 174908 @04114 024918 990044 agape eeavel 177777 
@001GG B40040 B88172 174617 Ava2ve A20200 aeepee 062736 BO10e0 
aue12¢ 101088 820000 00401 va4e1 apaue2 aeee23 Beever asaeee 
000140 G27733 GeaaGe eoeR08 110728 116720 aeavee weaved oeeces 
208160 142444 002600 145006 ngasee 144642 anenee Bvever oeanee 


LPeeee 
HEADER ADDRESS #® 820225600 ATL ADDRESS # 101@4@V/041240R 
H,CRisecacee 

. USER POR'S: #03206 611622 B00800 AoAveD BBA016 A77406 877486 877486 
USER PAR'S! @@2261 082270 @e¥eae aApoeee BB24602 BA2682 BvILe2? 177626 
Pse#17 4000 PCsg20006 
REa@OH37G RisiGia4e R2soQvGee R3sA90001 R48000809 R580904G6 SPaeggeiee 
INITIAL PS$8174847 INITIAL PC 8090196 INITIAL SPa@QQ1ue 
HEADER SIZEs@aaee3 DSWs00Gaa! NUMBER OF LUNSs6, 


LOGICAL UNIT TABLE3 
# DEV WINDOW weCTL w,VBN W.FCB F,FNUM F,FSEQ F,STAT NAC NLCK 


1 SYB eneene 
2 cOe aeaesa 
3. SY¥e egeeed 
a SYS geeene 
5 TIA aoeeee 
6 cla ggeeeae 
HEADER? 


B8evaG @G00OG 203206 011672 Aaasee ABGAAe AA8016 877406 377486 
AObn2Ee €77406 A8¢2261 802270 00000 a20008 900402 860622 201802 
288049 177600 200003 8000807 nganed aeaeee 80402 BbR6A2 201002 
eo6n6¢e 177606 174900 820006 880378 101240 820000 800001 290000 
020190 900406 O80108 174817 00106 480100 080000 880008 a90eee 
ee8120 10164@ @@9608 C2840, AGA4GL B0a083 A20004 Bd8KBW 200226 
206140 141022 GGG802 G80002G 760146 262146 200000 868900 069026 
A26162 145086 820090 142444 AGAAA6 145886 00000 1450806 440000 
888200 H20001 @80080 142526 BO8008 BQAAAe HAAGGOD BHeGOL AABLee 
A06220 ¥GOOGE 8880208 220008 ABBAGA2 BAAAGG BAAB0R2 8660808 840000 
008246 AGCBSA BOSCH BBFAAG AMCHHAD BAG0AB HEB200 808088 980000 


RsxellD CORE*DUMP ANALYZER 


TPp SCAN 


Syp SK 


CDA SAMPLE LISTING 


V86.2 5°0CT976 14:25 


TPD ENTRY ADDRESS ® 145108V/105300R 


BASE ADDRESS # 08120202 


ALLOCATION MAPs 
SPACE ALLOCATED 
@0120200~-98130100 


eeee® NO ENTRIES IN MRL 
eevet NO ENTRIES IN CTL 


MCR 


SIZE = 900077e8 FLAGS = @g0003 


OCCUPIED BY 
DB ees CA) 


vweewe 


ewes 


TPD ENTRY ADDRESS © 145124V/1853524R 


BASE ADDRESS 8 08130102 


HOLES; 
ADDRESS SIze 
22132300 09015600 


ALLOCATION MAP; 

SPACE ALLOCATED 
0013G1G0"-8u131100 
0613110408801 32300 
@61323G0-00150100 

eeeet*® NO ENTRIES IN MRL 


evewt NO ENTRIES IN CTL 


GEN 


SIZE *% 88020000 FLAGS 8 9239008 


OCCUPIED By 


eeeMCR CA) 
eee MCR CP) 


eeeee 


wweee 
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CDA SAMPLE LISTING 


RSxei11D CORE*SDUMP ANALYZER v26,2 
Ted SCAN 


TPD ENTRY ADDRESS © 145158V/185350R 


BASE ADDRESS a 698150100 SIZE & 01627700 


HOLES: 
ADDRESS SIZE 
28236700 80003400 
06244480 20004400 


88323500 00011729 
06436500 813413500 


ALLCCATION MAP3 


SPACE ALLOCATED OCCUPIED BY 
0015010008016 4608 TTeees (A) 
02 164600080203400 SYSRES (¢L) 
06203400080218302 TTLIBA (L) 
@292196300-80225600 TYLIBB ¢L) 
00225600009231 420 LPsees CA) 
00231 400—-902353008 MOseee CA) 
(06235308-00236700 eseVFY (A) 
08236760~980242388 
002423006002446400 USRTSK (A) 
00244400-89251000 
29251900-90254700 DK eees (A) 
089254700000261500 DTeeee CA) 
@6261520e280278600 MMoees (A) 
0427060090027 4500 OSeeee CA) 
00274300-00310400 DTAACP (F) 
00310400009323500 BPR... (A) 
88323500-80335400 
28335490000365200 FLLACP (A) 
00365200-00421 400 ee eLBR (A) 
00421 490090436500 oe eDEM (A) 
88436500-82000000 P 


‘eewet NO ENTRIES IN MRL twene 


cThe 
NODE ADR TASK PRY STS TI 


5e0¢T#76 14325 


185834 ee eL BR 58, wi TT108 


104760 146548 111440 182429 


143656 800462 470001 


FLAGS = 831014 


BOBUR0 


PAGE 20 


803652 


CDA SAMPLE LISTING 


RsxellD CORE*DUMP ANALYZER 
87D SCAN 


VO6.2 


ALPHA TABLE STARTING ADDRESS © 145200V/105420R 


TASK PAR FLAGS PRI DISK 
neee wren ee gue een enee@ 
ACCABT GEN 068200 58, 0B@ 
1826290 @03275 903244 145350 
102642 000080 1092642 102642 
ACCLOG’ GEN 060200 235, DBO 
10246¢@ 003273 046537 145150 
1025a¢ @0600G 192502 192502 
ACCOFF GEN @60200 58, ovBe 
182560 83273 057266 14515¢ 
1292600 Ga@00G 102682 102602 
ACCRPT GEN e2aeeo §86=6 «458, ~=s 
10252@ 003273 871424 145150 
{0254¢ @aCeee 192542 192542 
BPReoe GEN esa2ea 6 55@, «=i 
162100 697422 131574 1485150 
102120 eaee@15 102122 192122 
CRF eee GEN 020180 50, 088 
10556@ 012626 131574 145150 
1056990 paeCGee@ 183602 183602 
DB cee SYDISK 064200 248, DBO 
142190 014554 131574 1451e0 
142122 @60811 142122 142122 
OK cies GEN 64200 248, OB 
163420 15324 131574 1451560 
103442 CO8804 103442 103442 


SIZE 


ageaie 
nea2ee 
aeene: 
eeae3e2 
a6o2ee 
gvaael 
AGOB12 
n6e2e0 
ageaes 
000167 
azavee 
geeues 
ag0131 
n4e200 
aaaeee 
001067 
A20102 
aaeeao 
900077 
264200 
200001 
028037 


A64209 
Q80801 


SOC T#76 143 


25 PAGE 22 


NO, OF ENTRIES @ 69, 


LIM 


AV 


UTIL 
a, 48, @, 

014462 8700128 
184125 oageee 


0, 40, 2, 
914753 geaose2 
104043 142140 


Af, 48, De 
014462 


104114 


Haeb12 
60080 


@, 40, 28, 


014462 000167 


124135 142149 
1, 48, 13, 
014462 gaoa7e 
1143407 142449 
@, 40, 
914462 200145 
154672 103320 

1, 46, 9, 
01477@ 80077 
137665 oageao 

i, 40, 4, 


@14778@ 800037 
208066 2820080 


SRQ LISTHEAD 


PeVgeeven eeu @g 
102642 142642 


Q00018 924008 
B0A000 BB9080 


1w25e2 192502 


GOABI2 
200000 


824000 
2areee 
102682 1202602 
@2e012 24008 
aeovew asaoed 
192542 102542 
OB28167 a240e0 
980088 peve02 
182122 102122 


@00131 
goevee 


@24903 
080889 
183682 103622 


924000 
QE0B200 


001067 
142140 


142122 142122 


024901 
goaeee 


089077 
avaved 


193442 105442 


@0e037 
aunved 


@24001 
QB208R 


RSxe11D CORE*DUMP ANALYZER 


STD SCAN 


PAR 


TASK 


DS.eee GEN 
107220 
1072496 


DTAACP = =GEN 


103020 
103049 


OT sae GEN 


183668 
183780 


ERRLOG GEN 


104920 
104040 


FiiACP 8 8=6GEN 


1ali2e 
101449 


FiimMSG GEN 


184120 
104140 
LPeees GEN 
104360 
104400 


MCRERR GEN 


182320 
102340 


CDA SAMPLE LISTING 


V06,2 Se0CTe76 141 
FLAGS PRI pISk  SsiIZeE AV LIM UTIL 
eauevaee eee eeu @euee oe weaw eevee 
064200 248, 080 o90035 1, 48, 4, 
@16024 131574 14515@ 64200 014770 20035 
GB0004 107242 107242 ngage, 137716 aeageo 
@40202 210, 088 00141 8, 255, 2, 
016041 @03310 14515@ e4e2@2 2014722 ageo7e 
@20000 103042 103042 f00001 147772 aneaee 
64200 248, DB@ ea0046 1, 40, 4, 
016074 131574 145158 264200 014770 woeo46s 
eaeee4 103702 103702 a0eae1 141001 eeeseo 
044200 200, 080 agele4 @, 40, @, 
021042 046537 145150 044200 214710 @a0104 
eogese 104042 104942 pogoas 123515 142140 
940202 228, 08@ o00276 1, 255, 2, 
025167 03310 145150 a4a2e2 914734 ava2to 
Go@b@G 161142 101142 aeeage a52604 agegve 
g2a0g2 «6200, Dee 00853 6, 40, 2, 
025167 @52077 145150 A2ae@0 014718 ecae4s 
Q90000 104142 104142 ne00e1 745466 aeaoae 
@64200 248, DBA 000036 1, 42, 4, 
246634 131574 145158 64200 014770 @n0036 
Q@a0004 104402 104402 B00001 141022 eacaed 
@60300 75, DB@ A00086 0, 20, 2, 
B50712 @21042 145150 n6e3e@ 214513 agagas 
600000 102342 102342 negoe1 156004 102260 
e 
e 
@ 


A-9 


25 PAGE 23 


SRQ LISTHEAD 


PeowceF®vcaveee 
187242 187242 
ovewss 22400) 
908890 9280020 

103842 183842 


1774808 
480888 


o0e141 
80980008 


103782 103702 


888046 
860000 


224001 
A289600 


164842 104942 


000104 
avevoe 


824080 
G28088 
181142 101142 


868276 
088808 


177481 
Q88020 


104142 104142 


aveuss 
200000 


224060 
890000 


104402 1044982 


G68836 
G000008 


#24001 
eaeoee 
102342 102342 


ovaee6 12000 
200008 eacaee 


CDA SAMPLE LISTING 


RSxe11D CORE*DUMP ANALYZER V26.2 5e0CT#76 14325 PAGE 31 
PuD SCAN 
TT? 
FLAGS ATTACH RED HANDLER EXP CNT CHAR DACP ACP TERM 
age2ia TTO TT cee @. g90200 200805 


142300 @52124 194900 aeeoe7 Aesnee eeeRee anieee BeoveD 142300 
142329 108260 @9@008 202756 142324 ae0062 a20200 043140 adeace 
14234¢ 640401 600260 20900 oea2ee eae2e0 ageaes eeAeeY aee0e0 
142360 ea0000 


1/0 REQUEST NODES: 
REQUESTOR ATL NODE DPB Sz PRI LUN EFN FUNC CODE REQ@ TYPE 
USRTSK 119200 8, SQ, te 2, 10,RL8 NORMAL 
118720 060146 060146 105520 119200 994862 aeoe8i Buivee eoeee0 


119746 OA08GA C080401 881536 800122 800000 420481 08080400 2928000 
119760 143746 880800 889000 480080 AG2021 B6800$ 820008 280080 


Cre 
FLAGS ATTACH RED HANDLER EXP CNT CHAR DACP ACP TERM 
aceees TT@ a, 2800288 888890 


142362 444583 600000 888000 Bav090 9000200 800008 880890 142300 
142482 CBCRCG SEO8BH BGAGGGD BHAA29R BA0000 A00080 800000 88929000 
142422 G@B0000 G20G88 2002800 A00000 O828020 800008 840080 280000 
142442 OA8008 


tewse JI/Q0 REQUEST QUEUE EMPTY weeee 


coe 
FLAGS ATTACH RED HANDLER EXP CNT CHAR pacP ACP TERM 
goee8p TT@ 2, geooge eeseee 


142444 647583 200600 asagee fA0888 200080 880008 880008 142580 
142464 OG808H S08088 898008 8800008 2800000 089080 888000 98080860 


A-10 


CDA SAMPLE LISTING 


Rgx~e1iD CORE*DUMP ANALYZER V06,2 SeOCT#76 14125 PAGE 32 
Pup SCAN 


142504 AUGeeG e00000 aeegee Beasee eeeoee eeeeee eevee eeesee 
142524 e00000 


eewee J/O REQUEST QUEUE EMPTY weeee 


CL@ 
FLAGS aTTACH RED HANDLER EXP CNT CHAR DACP AcP TERM 
egeeeo LPe QO. eagoee gaceas 
142526 046103 Sua0e8 e@ee0Re Anevoee ADeeee Aneaee BYaveHY 143264 
142546 O98080 890000 agaege aveaee AgeeeD eneeeBW BeAvee BaeaeD 
142566 288008 920000 aeneee aoegee ageaee Aneeae BaeoveY aApaeea 
142696 egeoee 
eeeee I/O REQUEST GUEUE EMPTY weave 
BPG 
FLAGS ATTACH RED HANDLER EXP CNT CHAR DACP ACP TERM 
ageeea 1T4 a, ea220e ea0ee! 
142610 @50102 @2a00e2 804883 ptee08 euaeee apAeae ABevAaR 144166 
14263¢ @B0800 @80000 142634 142634 agaeee aa00e2 seoveN apeeee 
142650 060403 GB820@ 800008 Aagaee agaede agave, avaooe wHvoeeR 
142672 SB2008 
weewe I/O REQUEST QUEUE EMPTY eveee 
Spa 
FLAGS ATTACH RED HANDLER EXP CNT CHAR DACP ACP TERM 
oeoeees SYo a, eee200 g0a000 


142672 G50125 @08000 889200 A280000 ABe080 HA0000 A80000 145806 
142712 BB0000 B882000 142716 142716 ea00ed ea0age ageeee 420000 


A-11 


CDA SAMPLE LISTING 


Rsxel10 CORE*DUMP ANALYZER V06,2 5e0CT#76 14:25 PAGE 43 
MCR COMMAND BUFFERS 
NoDE ADDRESS TASK TI LENGTH FIRST 40 CHARACTERS IN BUFFER 
Fee Sts ®*naouae even | Ad eernunvneaw SOS VPeHF See STOoSFZSVeGeseSVevesee 
11196@ oe eL BR TT12 24, LBR COAOLBsLPt/LIsCDACKG 
Rsxel1D CORE*DUMNP ANALYZER VQ6,2 5e#O0CT#76 14325 PAGE 44 
BATCH COMMAND BUFFERS 
NODE ADDRESS TASK TI LENGTH FIRST 4@ CHARACTERS IN BUFFER 
Fee esFavoawee a2oan se eseaune SOS sTSASBeEsSslPGSlSTUese2eaNseawveres 
111729 eee VEY BPO 1a, VFY SYe#/Lo 
RsxeiiD CORE*DUMP ANALYZER V6.2 S-0CT#76 14325 PAGE 45 
FTL SCAN 
OTAACP 
FTL ADDRESS = 187440V/947640R STO ADORESS & {03020V/043220R 
LOAD ADDRESS = 00274322 
PARSGEN PRIa2iv, 1/0 IN PROG#A, 1/0 PENDSs2, STATUSSLS TIstT7 
FLAGS wORDsga2900 FLAGSs@aoge0 Ba9002 MASK$8144642 B964%g1 Q@B0v08 ooeGee 
107449 146404 146404 182368 143742 00322 apaged BeAeae 802743 
107469 090004 193020 8090800 agg0e0 144642 206401 s@eae0e anebe0 
107500 14535@ 187502 1879@2 @80001 147772 e02808 107514 107514 
RSxw11D CORE*DUMP ANALYZER V6.2 Se0CT#76 14325 PAGE 46 


AST QUEVE SCAN 


TASK & USRTSK ATL ADDRESS & 110280V/050490R 


TYPE w MARK TIME ENTRY POINT # 001000 
ADOITIONAL INFORMATIONS, 890000 


118449 
118469 


110500 
BaeRee 


110242 105520 aoesee aoioee 
@oegee @o100@ 242300 176740 


TYPE w 1/0 DONE bwrry POINT » 8013328 


EVENT FLAG « O, I0SB ADR s #90088 IoS8B CON 
118500 118340 130449 195520 980481 994962 
116520 861330 080401 820041 2800120 006403 
110540 143740 @00088 802000 202441 agaied 


TYPE = TERMINAL ENTRY POINT # 001330 
NO ADDITIONAL INFORMATION 


118349 
110369 


110242 
118260 


110500 1955290 
20000 800173 


880018 491330 
130180 177400 


A-12 


STD ADDRESS 8, 185520V/@50422R 


@80000 860008 a08008 
@80015 808525 808001 


TENTS = 00640i 900883 
Oeaeeat 
00008035 
2010880 


O81088 a80000 
008088 600000 
9280208 200001 


883880 
a05422 


621086 2808000 
00944353 880000 


CDA SAMPLE LISTING 


Rsxel1lD CORE*DUMP ANALYZER V6.2 S*0CT#76 14325 PAGE 47 
SRQ SCAN 
RECEIVER SENDER TI PRI DATA BLOCK 


sacs e%a weeeae ow oo Seneeaqgrena 


SPReee ee GUE TI2 188, OS0114 31000 240001 841104 8080000 
200172 800001 A00008 284477 852140 
OAG00G 47014 A000035 


RSXe110 CORE*DUMP ANALYZER ¥06,2 5e0CTe76 14325 PAGE 48 
CLOCK QUEUE SCAN 


TYPE © TIME@SLICE DELTA & 1, TICKS 


1060690 184320 146406 142100 145600 ag90000 00001 dve4e8 145358 
106106 @06000 166102 186182 ag0ees 153252 142148 s8a008 aoaeee 


TYPE = MARK TIME DELTA s 22, TICKS 
TASK & ,.,,D0EM STD ADDRESS # 183360V/044524R 
ATL ADDRESS ® 111360V/244526R EVENT FLAG # 2, AST ADDRESS & 442020 


104320 180640 186060 123366 111568 ag008e@ agas26 eHeeee avazee 
124342 111484 8280082 @00000 O00080 164434 142140 280000 ag0000 


TYPE = MARK TIME DELTA » 8, TICKS 
TASK & TTyse0s STD ADORESS # 141740V/041044R 
ATL ADPRESS © 180260V/041046R EVENT FLAG # 6, AST ADDRESS = Bev200 


120649 1194@@ 104320 141740 100260 aon8e2 ega010 seeeee Bo0040 
10066¢ 1003@4 O808086 6228000 ACLAER GRAZE FH2000 200000 200000 


TYPE = MARK TIME DELTA » 22595, TICKS. 
TASK & BPReoe STD ADDRESS = 182100V/050624R 
ATL ADDRESS #8 11144@V/050626R EVENT FLAG # @, AST ADDRESS s 062124 


118406 186320 176640 102192 111442 @¢0008 854103 apeeee sBoo0e8 
110424 B200O2 BOSH 882124 BKCHRA SCARCE AAA20R8 B69000 a2aveu 


TYPE = MARK TIME DELTA # 589675, TICKS 
TASK = USRTSK STD ADDRESS #® 105520V/046524R 
ATL ADDRESS ® 110200V/046526R EVENT FLAG @ 1, AST ADDRESS = 601080 


106326 146400 118468 105520 1102800 a@¢Ao87 143351 ab00ae Anade) 
106346 110224 @8800001 801000 8134482 a8a008 8900200 B8o8080 127038 


A-13 


Rsxe1l0 CORE*DUMP ANALYZER 
Gcd SCAN 


NAME ADDRESS SIZE PAR 
TTLI8B @82103 802153 GEN 
142249 14220¢@ 146356 
1422690 001404 gae4det 
TTLIBA 882034 900047 GEN 
142200 142140 142240 
142220 621004 890403 
SYSRES 001646 008166 GEN 
142140 146356 142260 
142160 90004 o70403 

weeee THE FOLLOWING 

CRF.ee G09900 #086001 GEN 
1893320 eaeeea eaaac0 
10334¢g 200400 820401 
MCRERR ega0ee 299023 GEN 
182260 eeegee Beeace 
182300 060400 09940} 


eyeACT 90800 00007 GEN 


182660 
1227909 


28082 829088 
@0100@ 821802 


oe,DMP @00R8@ 00126 GEN 


103520 @oae08 eaeo0e 
105540 a61000 eeae00 
ve EOI @0000@ 020142 GEN 
101449 egeoee aecece 
101462 200480 eaeeee 


CDA SAMPLE LISTING 


V86.2 


FLAGS STS 


@20002 LS 
188054 934222 
145158 014482 

000002 LS 
190054 434221 
145150 614482 

200026 LS 


@75273 8786533 
145350 014426 


ARE GCD NODES FOR PURE AREAS 


ggeee@2 NL 
629035 ag0008 
145150 414492 
eoo002 NL 
200035 Agonee 
148150 414402 
820882 NL 
222835 agoade 
145158 a144a2 
600802 NL 
820035 aecoeD 
145350 014482 
@g@0e2 NL 


280035 agea0e 
1485158 014402 


A-14 


5°0CT@76 


ACT/INS 


Le/ie 
282193 
020401 

1/1, 
882034 
028401 

4,/28, 


281646 
216004 


Be/le 
eoege0 
020400 

O./1, 
eoooe" 
eee4e0 

O/i, 
200080 
g20400 

O,/i, 
920000 
00040e 

O./1i, 


AGGRO 
000408 


14325 

CREATED VIC 

Fe evewe see 

6e0CT#76 41,2) 
80153 0800114 a02e012 
AQOG0O2 800802 027451 

4e0CTo#76 (1,4) 
080047 800114 802812 


Ofee9@ B000G2 224645 


28eSEP@76 (3,1) 
B00166 008114 B16011 
OG0000 800608 110006 

eeked 

28eSEP~76 tie) 
600001. 880114 816011 
ageeee e9e9e0 154727 
3OeSEPo76 (1,1) 
@90023 800114 017813 
200080 800081 156085 
3SO=SEP@76 (222) 
900807 @vB114 @17011 
0800008 880001 155524 
2BmSEP=76 © (8, @) 
20@106 860114 816011 
200000 309000 126572 

Se0CT#76 = (0, 0) 
900142 900114 ae2412 
@genee@ evevei 15164} 


PAGE 49 


CDA SAMPLE LISTING 


RSxeii10 CorRE*DUMP ANALYZER V2602 SeOCT#76 14:25 PAGE 5@ 
GcCD SCAN 
eeeMAC Bag088 @90i13@ GEN eeeeee NL Befis 5#0CT#76 (a,0) 


101349 280000 880000 2880035 apeeee aeepee aeai3se 400114 aa2412 
18136¢ 008400 B80008 145150 014402 200402 a00000 eevee 123273 
op» MCR O21511 6@0@12 MCR g0eee02 LS i,/i, 3QeSEPe76 (1,4) 


102162 @20002 @80000 800035 aneaee a01311 @negi2 @00114 Bi7e11 
10220¢e Q20404 B00401 145124 014402 099491 geese avavel 156055 


eee MFT 88600008 6@¢023 MCR @@@@02 NL Bale 3@eSEPe76 (2,2) 


162220 CG00GG AE80C8 200035 BaRtee anAeee 498023 800114 a17011 
102240 @B0402 @61002 145324 614482 000400 oneege evevel 156125 


eeePIP O2A800 @80063 GEN weeee2 NL Z./1, 28eSEPe76 (8,2) 
10462¢ CO000G Bo0a0d B00035 apAeee apegne Baee63 A0e114 16011 
104640 CA040G @20000 14515@ 014402 aaa4ee aaeoea aveved 126107 

oe -PRE @peGee pe0215 GEN @00@@2 NL Zi, 29eSEPa76 1,1) 


104720 PBQOGR 620000 A80835 Aeeaee Bavoow 448215 9801149 B16414 
12474¢ GH2000 00401 145150 414402 apadad apogee evesei 131676 


op QUE 200888 @@GG58 GEN 0@0802 NL O,/1, 28 eSEPe76 [208,208] 


185160 BOCGCG AHGOCH A200035 aneoaee aeeeee Bneo5e Bve114 16011 
105206 800406 100209 145158 914402 apadoe anaeea avooed 167001 


A-15 


CDA SAMPLE LISTING 


RgxeilD COREeDUMP ANALYZER y¥06,2 5Se0CT°76 14:25 
PooL VERIFICATION 
CONSISTENCY CHECK OF POOL BITMAP AND SYSTEM LISTS: 
BITMAP INOICATES 347, NODES IN USE OUT OF 1112, 
LISTS INDICATE 387, NODES IN USE 
eeeereceweee JTMPORTANT NOTE wuconvtevere 
* 
* THERE WILL ALWAYS BE SOME NODES * 
« THAT ARE ALLOCATED IN THE BITMAP BUT * 
* NOT FOUND IN THE LISTS, SINCE ANY * 
* PRIVILEGED TASK CAN PICK NODES, * 
¢ * 
RECEP EHHTEREPRHHEHHEKEHKERE KE HEE EREPETH ES 


NODES ALLOCATED IN BITMAP BUT NOT FOUND IN LISTS3 


10014¢ 
108360 
108200 
100220 
188249 
1071¢2 
107126 
107142 
187320 
187349 
107560 
107660 
110049 
11®966 
118180 
118260 


100140 
198160 
1d@286 
secoee 
800020 
eeaeae 
GO8088 
289800 
egeoae 
#20080 
090080 
eeo0e0 
110046 
142080 
SGSCBG 
060146 


128149 
100160 
108200 
@00080 
0a00e0 
200647 
2200e8 
228080 
280006 
888008 
220880 
298008 
1190490 
0315690 
220008 
110720 


18@144 
160164 
898080 
280000 
280080 
GOR88e 
228000 
28ego00 
202080 
a20a0e0 
222080 
200008 
119044 
200080 
802200 
110128 


100144 
102164 
av127e 
2028000 
086000 
A00008 
A22A0G 
08080 
060000 
agaaeg 
AGAGCR 
208080 
119044 
Al08a 
AVAGO 
164760 


A-16 


180158 
194170 
298080 
220000 
222099 
@B8008 
200008 
200000 
220006 
020008 
AABBOR 
200080 
008800 
48080 
BAAA08 
026062 


190156 
100170 
Q88088 
AdB2A0 
282008 
200088 
200880 
806800 
A00880 
886000 
208080 
89880 
@11822 
200000 
208080 
016821 


140154 
108174 
2800080 
Q6eed0 
@oeeob 
BBG0a0 
Qo00a6 
C4auoe 
Q208e0 
00080 
200080 
E000 
220800 
2000800 
260080 


B01038 


PAGE 91 


196154 
180174 
8282880 
2000808 
220008 
B82080 
42080a0 
A288008 
288080 
AvAUae 
@82280 
G20880 
a80080 
200880 
00020 
826542 


CDA SAMPLE LISTING 


RsxellO CoRE*=DUMP ANALYZER V@6,2 
POOL VERIFICATION 


119300 
110320 
110560 
1186¢0 
118626 
1166 4¢ 
118664 
119700 
1113¢e 
111320 
11134¢ 
111560 
1116a¢ 
111660 
1117a¢ 
112060 
112120 
112120 
112146 
112160 
112200 
146920 
146940 


146066 


ABSO8E 
143656 
860146 
209080 
143740 
118720 
A2ESBOB 
143746 
118720 
600800 
144332 
0A6B880 
4200880 
886006 
AGACRE 
112226 
i11v@6@ 
144642 
142000 
AGAABE 
143574 
408080 
705002 
177666 


NODES FOUND IN LISTS 


200401 20046 ageeo! 
Q@o0000 ee2een ne4142 
260146 105520 110200 
(900401 220036 agoiee 
@egoee ap2cen aneddy 
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BeG200 204767 166244 
012700 @07552 004767 
205046 016705 156006 


§e9CT#76 


200080 
028001 
04062 
POAA80 
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024062 
420000 
O88021 
905746 
200037 
@80120 
AZABSD 
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BA0A80 
A0AGGO 
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ASAABE 
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08000} 
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012600 
165624 
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BUT NOT ALLOCATED IN BITMAP? 
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PAGE 52 


000137 
110334 
gvevee 
avecea 
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aneeas 
900370 
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CDA SAMPLE LISTING 
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NODE POOL DUMP 


SYSTEM NOOE POOL 
# sw NODE ALLOCATED 


VIRT REAL CONTENTS ASCII RADS® 


1900089 a40200 145642 145642 142190 990003 "K"KeD 2@wJ 2wd ip C 
100018 492120 @83212 oeo000 agngad Boaage AAs 

190020 ¢48220 @eeeee eee0ae eAaaee agence 

108096 2840230 @20G00 e82000 ee2000 vesaae 

100049 849249 100100 041540 142100 013746 ® Cep TT2 JiH 1P «C28 
1ge¢@50 94925¢ 172346 042737 ee4ea0 ten104 2—£ D0 9GN KGG AKH TT6 
19006¢ 940260 @12737 901205 172346 @en137 a CS9 PE 9GN BO 
190070 040272 264492 eg0e08 eanege eo0eee 8B P$J 
100180 948300 @0e0geq eep0ee @an0e0 aaca0e 

100110 @40310 299080 @eecee eea0e0 agaceo 

100128 940320 Seeeee Bee0e0 evased agooae 

100130 2940330 @80900 eee00e e2a000 ean0ee 


100140 9403490 120149 100140 100144 180144 TUX TUX TU, TU, 
10@015¢ 94935¢ 102152 180150 100154 100154 Tu2 TU2 TUB TUB 
1001960 948360 100160 100160 100164 100164 TV TV TVD TVD 
100178 949379 1@@17@ 1880170 108174 160174 TVH TYH TVL TVL 
10@02@8 9404200 100202 129280 890008 #881279 8 TVP TVP QP 


106218 4404108 200000 8209008 G090002 faned0 
100220 040420 Q@00000 8800008 8023000 #000008 
108250 940430 20088 888000 O27000 420000 
188240 040440 260088 880800 800088 800200 
100256 940456 Q28000 8en200 e22008 ea20000 


190260 949466 101049 145600 141749 144332 K CZH T22 2VP 1MxX 2ER 
100270 949470 288379 @ga9ee @onea: 01501 A FH A 13 
1903@@ 440500 @BGG16 141749 ganDed a4ng00 Cc (Ce N 1MX Jix 
1@@3i8 248512 007377 a6e00ge e9nBGe BeAeee BOS 

100328 4420520 145150 100322 190322 @eae02 JR R 20P TXR TXR 8B 
100330 0428530 @27733 @@9000 109334 100334 [(/ \NN\ GékK TX, TX, 
100340 940542 19049@ 020240 1417466 033746 C TYX D 4mx C28 
108358 940550 172346 042737 19200 ig0100 aE ® 9GN KGG BVP TT2 
100368 94056e 912737. 082103 172346 ae0137 4. C 4. j|CS9 $k 96N 60 
102378 2040870 268174 884840 289526 a@a000¢ V Oat AL HV 
108484 949690 100440 @00200 141740 013746 C TZP CH IMX C28 


10@418 4442616 172346 042737 G2000a0 i1a2100 
100429 949620 @12737 @82183 172346 900137 
100430 942630 062446 @009000 e01200 eaecee 
100440 949649 180506 @0014@ 141740 213746 
10045¢ 840650 172346 042737 006400 120106 4 
108460 948660 012737 082193 172346 020261 1. C 1 #£4.>CS9 $K 9GN 0G 
108472 848670 @00137 @60174 anRve0 ooneaDd BO OGT 

100580 942790 100549 @00100 141740 013746 e 

10051e@ 48710 172346 042737 Bv1082 108106 4 

100520 940729 012737 082193 172346 @@9261 ,C 1 j%cS9 SK 9GN Da 
108552 240730 000137 062446 000526 ageaei , & 

10054a 949749 190689 200042 141749 013746 C Te2 2 MX C28 
100550 048750 172346 042737 800001 100106 +e 
100568 2840760 212737 082193 172346 800137 14 C «4. jCcS9 SK 9GN BO 


eeeceeeeeeceeeeeeeeeeeeeeeenee een eeeeeeeeeee ee ee eet 
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108680 @41000 180780 880040 141740 0813746 Cc 
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180620 841020 612737 0802103 172346 400137 


oa 
Qa 
an 
a, 
i a 
") 
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1@1128 941326 @25167 903310 145150 048202 «HH J Fii ACP 2OP JL4 
101138 4413308 914734 900218 @@0276 177401 \ » DET CP 08 2A 
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TASK © soeVFY 
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200249 eneeee BeoeRee aeeeee Boeade 
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000270 goeees e9ege@ eeaneg ag20ee 
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TASK DUMP 


208622 ACG8@8R B8e80@ BebBAR ABeBES 
238630 A2Q000G 880800 890880 900008 
100642 00062 8200208 ee2080 Avened 
208650 GOG08G S20088 802098 200000 
B20660 O808080 B20888 499000 a90000 
020670 800080 820090 g@20000 200008 
208700 Q20@606 880008 a90800 aveaned 

8807 12 MACGBA B20008 820080 009000 
820720 C02028G 889008 220000 AgeRe0 
008730 BACGAB B20800 2880900 ag0n00 
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820750 488088 G609828 800880 Aa0e000 
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000770 QOG60G 20808 80G088 00455 ° GU 
201200 012746 200455 104377 aga000 bd CTF GU U61 
081010 @A0080 800208 220008 4000900 
001020 BY0E8H B60020 880880 290000 
021036 Q28008S BESBRB BOALBR 420080 
801448 20000 O880008 B@20820 neQKve0 
@019850 BGABHCH SBAG8G B68000 200000 
001066 O636000 220000 800080 n29000 
201870 B48006 CA0B8G 208080 00000 


eol1a9 002444 000034 gee800@ aoeaen $ 26 ® 

@0111e 277406 a00@16 877496 077496 TL8 = =0N TLS TLB 
e@1126 277406 882372 BbeBee ABeBeO TLS 14 
@b113e 624365 e@99402 aa96892 av19e2 AQM FR JZ L4 
201142 177690 @0@e83 ee04ee aeeeKeR 5H C 

0011590 20000 880482 900602 aAB1002 FR IZ (4 
261160 177640 174900 280656 111000 : 5H 9SA J@ WNP 
Q81172 690000 8040064 Ban8e0 281277 4 ? AL Qw 
el2ea 060194 680180 174017 980100 De 9 OPO AX 9$w AX 
@01210 ¥O018G 820000 ee000e avedve e AX 

221228 OOCGCH Be0080 281902 ned4e; Lo FQ 
801230 200003 680004 aaageee vaa826 C D v 
a01246 156262 828000 20000 60146 aN SLP OPs 
ea125e2 060146 @20008 aageee angecs OPPs FF. 
@0126e 142444 ¢aagee Ae8081 aBeoee $E LU, A 
201270 145696 @9000@0 145006 aAggaee Jog 2L8 2Ls8 
BBl3a6 028001 206000 142526 agagag VE A ivé 
@e1312e QH@GGO GB@00e sae0e2 aAvoave 

201326 0@002G eanee2 eaneed agenee 
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2013428 O6000G 220000 aee8ee@ agaued 

#81350 CQ902G RANGG0 BeeBEee BeERe0 

@01360 C60@@@ @00000 an6000 se0000 
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Rsxeii0 CORE*DUMP ANALYZER - V06,2 SeOCT*76 8 =«.: 148 25 PAGE 182 
8GA DUMP 


SGA = SYSRES 


200008 @17646 880009 832736 019200 & aS EBY HX@ BVP 


@00010 8801003 062716 aaeee2 013607 NE LS PKV B COW 
808020 024567 816322 210246 016605 wps ATW DXP BZV D,7 
geen3e @OG012 O12582 011566 n0012 BV J cpa COV J 
000840 004767 000224 805005 05006 is AW1 Cy AXE AXD 
820050 @05003 205762 aoe004 an1004 R AXC ABR D L6 
ee8n60 42762 810002 e2e0e8 400403 RE kGZ BYP Fs 
608072 @204767 G0A380 103412 016202 we Awi D2 UXJ DVR 
000100 202010 861405 832762 410002 R5 H SM HYJ BVP 
000118 COGGGR 881354 400778 412602 Lx Re LX C02 
200120 20207 613783 200026 204773 a Co c2C OF AWS 
08130 00818 000744 122718 aogees D Hx H LO Zu C 
800140 OG@261 O83851 884567 16174 1!) Ww DQ 9@ ATW DVL 
808150 @1@246 813702 eo0ee6 216202 & 6 BZvV C28 OF ODVR 
80160 @808G2 885712 @800261 201436 ya: B ASR DG Sé 
808172 @2626¢2 800014 goe0e2 . 281004 Q, GF L 6 L6 
800200 @26260 800016 a00204 701403 Q, GF N D SK 
08210 862782 O8e020 200762 avsees BE R PKJ P LR AXE 
200220 QB5004 121027 @08084 1034287 : AXO Y7U0) DO UXG 
000230 @16004 096086 121027 400005 " DSL F Y70 € 
egbe40 183402 016005 ea881e 2005283 UXB DSM HH AXC 
200250 156083 620001 024767 Anveo1e \ Ww SHC A AWL Ht 
008266 004767 888118 @12602 000207 WH. AWS a2 caz CO 
00270 @10246 832762 Giee0e aADeaee & RS BZV HYJ BVP 

28300 21085 816202 800018 901371 Y L7 DVR HSA 
228310 @126@2 098207 6285762 Aoe010 R Caz CO A6R H 
200320 661773 G18246 010246 16262 (es “YS BZV BZV DVR 
800330 @H@012 028216 O81414 32762 R5 J EHN ST HY 
000340 810082 800082 2801370 252762 xX RU BYP 8 MOB 
00350 010082 808002 016216 900006 BVP pve =F 
828360 @214@2 G11622 080764 005726 TV SJ CD04 LT ASe 
028379 0126@2 800743 905046 416246 ces CQZ LC AX8 DwN 
800400 OBeG@G 042716 178088 B085046 NE PR KF@ SP AX8 
688419 @05046 816246 ase0d4 a16246 && & AX8 DWN  D DWN 
200420 C0022 610546 813705 nagede FE B BIN C2E F 
800432 010446 881906 1295783 #01004 e c¢ B/@ LS VNS L6 
200449 @10504 962704 00004 216416 D OE Ber PKL OD B/F 
000450 @B50246 158316 201002 412716 & NP ON AX@ SPN L4 CSV 
00460 @00037 816546 sneege 412746 F OF 1 Def CTF 
600470 81018 012746 06001 104377 Fo M CTF A63 U6) 
eeesag 193420 642762 810009 Agaee0 RE UXP KGZ BVP 

028510 105723 801013 012746 100037 c)U*#*F VNS MC CTF 4 
208520 @12746 001051 104377 105714 Fy kt CTF M3 U61 YN, 
eee53e 106004 @52762 210082 oB80080 RU TSL MGB BVP 

990549 @a2261 8090207 @24567 ne5244 1 ws DG CO ATW A.D 
e0esse 12768 @00001 aa0852 216001 Pt CTP A AB OSI 
800566 80670 B01002 800167 aAga6le 8 Ww AP L4 B9 14 
800572 132760 @00001 090016 01063 PS 3 s0P A ON ONG 
80h6a0 132760 090001 anes: 901432 PS) /DP AOS 
800612 @24767 006028 132768 a00040 HPS AWL A7JH /DP 2 
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RSxe110 CORE*DUMP ANALYZER VG6.2 5°0CT#76 14825 PAGE 183 
8GA DUMP 
88062¢e 060017 8601416 122760 a00001 P% Oo SV ZV A 
880630 GB0000 221407 824767 905656 Ws $O AWi A4Q 
880649 103007 612770 177777 “86030 X oe UG@1 CTX 890 x 
@0065o G2G403 816082 880030 168192 “Be FS DSJ x 58J 


920660 004767 815012 816001 a9007¢ W 
889679 @04767 611532 116082 900052 wz 
800709 805885 1560095 e80055 200412 
000710 024767 O11512 183007 905702 wd 
208720 @82405 132760 a00002 1209056 PS, P 
906730 OG1481 111102 816101 avoule 8 A S81 we6 OTS) J 
808740 77515 1186260 a0¢e52 116046 M,@ * 
* Ww 
i 


900760 ee0e52 244767 807252 205g25 ‘ AB AWL BMG AXU 
@02760 «6910604 485046 132760 aeooie PSs B2D AX6 /DP oH 
@20770 «= «aed 201426 132760 oog041 #4 PS} 5 sé sDP 3 
@21000 880817 a01022 132768 avoo2e P5 O MJ s0P P 


@eleie 600051 801405 018046 62716 ) 
eola20 900120 812746 401007 813702 PF 
@91030 BBGGG2 862702 Bee810 AB5712 8 
081940 041403 G18246 012746 201001 &F Sk BZV CTF L3 
aelgse 132760 068001 sBee043 9012003 P5 # . 
201060 B19846 012746 807404 410625 g F 
801070 810446 012784 @10000 005760 & 0 
g9lieg 020876 108006 862705 aveaea > 
801110 16015 020076 042715 1a0u00 > 
681120 064767 811262 812686 11269) w 2 AW, B92 COB W635 
Pp 
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201136 @a3e02 110168 .eaee52 132760 ¢ PS 8R WOP AB /DP 
80114e 020206 800051 881516 162706 N FE CH AA UF 60V 
elise OA00466 B10682 019246 12746 & F 2 828 BZV CTF 
081160 @01077 104377 16203 Aveal4 — NO U61 OVS LL 
8o117a 062706 @80048 012746 131574 FE F \3  PKN 2 CTF oes 
001200 612746 874522 810601 910002 F RY CTF SPR 682A BYR 
801210 @62702 O60102 016246 00016 BEB & PKJ AZ OWN ON 
681220 016246 820014 016246 a02@012 & & OWN L OWN J 
aol23e 016246 @60012 816246 gve086 & & DWN HH DWN F 
001240 016246 800030 016246 aoev26 @ & DWN XxX DWN Y 
801250 016246 820024 836246 000034 & & DWN TOWN , 
02126¢ 016246 8080032 012746 2900001 e F Dvn Z2CTF A 
0012798 116846 600074 114566 neeve1 &< Vv XON AT WOO A 
281300 @16646 620072 810692 005046 & 1 & O1F AR 826 Ax8 
801310 019246 @05946 995046 g95a46 Rees B2v AXS AX& Ax8 
601320 QG5046 616146 @20802 711146 BaF OF AX8 DU@ 6 B70 
8013390 012746 04511 164377 162706 FI. FE CTF ASQ U64 PKN 
001346 060036 116001 220842 216002 " @xeQ 4 OSJ 
001350 068072 116803 280074 710346 1 <Ff AR x8S AT B,F 
001360 010246 010146 @12746 02007 & FF BZy 8X8 CTF Yj 
001378 184377 665862 000672 105060 2@3 28 U61 AYH AR VOP 
201490 080074 604767 011142 000167 © wBw AT AWi 87Z 89 
801419 @26226 204567 004376 904767 WA W B V ATW AQV AW] 
081420 007452 103443 132768 200001 «4 PS BOB UX5 /OP A 
01430 OG@017 801441 132760 ngeare 1 PS 0 TA /DP 4H 
001449 @00051 001404 112760 177766 ») PV AA SL W9OX BF 
021450 OB0052 488427 804767 211360 ¢ WP AB F9 AWl CAH 
001460 816001 880072 616123 sab0002 8 ¢ DSI AP DT6 8B 
@@147¢ 816001 @00030 804767 nvO4da2 W OSI X AW, FR 


A-23 


APPENDIX B 


TKB15.CMD FILE 


See Section 6.3.1 


C11,15)TKB15.CMD 


INDIRECT TKB COMMAND FILE FOR THE RSX“11D EXEC 


11,17) EXEC/*HD/-FP, (111,15]EXEC/CR/=SP, (1,1 ]EXEC.STB= 


IF A MAP IS NOT REQUIRED PUT A °¢° AT THE BEGINNING OF THE ABOVE LINE 
AND REMOVE THE °;° FROM THE BEGINNING OF THE FOLLOWING LINE 


(11,17) EXEC/*HD/-FP,, (1,1JEXEC.STR= 


eo Se Be Ve VE Se PY BO FO Be BA Ye Ve VO 


e 

(11,15) EXEC/LB:EMO0 
{11,15JEXEC/LB:EmMOo1 
(11,15) EXEC/LB:EMO2 
(11,15JEXEC/LB:EM03 
(141,15JEXEC/LB:EM04 
(11,15) EXEC/LB:EmM05 
(11,15 EXEC/LB:SEM06 
{11,15]EXEC/LB:EM07 
11,15] EXEC/LBsEMO8 
(11,15]EXEC/LB:EM09 
(11,15) EXEC/LB:EM10 
(11,15J)EXEC/LB:ACCTET 
(11,15)EXEC/LB:DMGCL 
(11,15JEXEC/LB:DMQ10 
(11,15) EXEC/LB:DMGLI 
(11,15) EXEC/LB:DMASS 
(11,15)EXEC/LB:DMALP 
(11,15) EXEC/LB:DMREQ 
(11, 15J]EXEC/LB:DMSCH 
(11,15) EXEC/LB:DMMKT 
(11,15]EXEC/LB:DMCSR 
(11,15)EXEC/LB:DMCMT 
(11,15]EXEC/LB:DMSED 
{11,15]EXEC/LB:DMSUS 
(11,15) EXEC/LB:DMEXT 
(11,15) EXEC/LB:DMGTP 
(11,15) EXEC/LB:DMGPP 
{11,15 ]EXEC/LB:DMGMP 
[11,15] EXEC/LB:DMGCP 
(11,15J]EXEC/LB:DMSAR 
(11,15]EXEC/LB:DMABO 
11,15] EXEC/LB:DMF IX 
(11,15) EXEC/LB:DMDST 
(11,15) EXEC/LB:DMDCP 
(11,15) EXEC/LB:DMIAR 


TKB15.CMD FILE 


(11,15) EXEC/LB:DMSDV 
(41,15]EXEC/LB:DMAST 
[11,15JEXEC/LB:DMATX 
(11,15) EXEC/I.B:DMGSS 
{11,15]EXEC/LB:TSCH 


? : 
(11,1S5JEXEC/LB:NTRACE 


THE EXEC 1S NORMALLY BUILT WITHOUT ODT. TO INCLUDE ODT IN THE EXEC 
CHANGE THE NEXT SPECIFICATION TO BE: [11,15]EXEC/LB:ODT 


THE SYSTEM IS RESUMED FROM ODT BY KEYING "CONTROL C" 
THE SYSTEM IS RESUMED FROM A BREAKPOINT By KFYING "Pp" 


11,15]EXEC/LB:NODT 


THE EXEC IS BUILT INCLUDING A CRASH MODULE WHICH CAN OPTIONALLY WRITE 
MEMORY ONTO A DUMP MEDIUM AND/OR DISPLAY A CRASH MESSAGE. IF MESSAGES 
ARE SELECTED ONE OF THE FOLLOWING WILL BE PRINTED ON THE SYSTEM 
CONSOLE IF THE SYSTEM CRASHES. 


ODD ADDRESS OR TRAP 4 
UNDEFINED SYSTEM EVENT 
AST NODE PICK FAILURE 
FLOATING POINT ERROR 
MEMORY PARITY ERROR 
NON-RSX EMT EXECUTION 
RESERVED INSTRUCTION 
SST IN KERNEL MODE 

RED OR YELLOW STACK 
EMT 377 IN KERNEL MODE 
UNDEFINED SYSTEM ERROR 


THE OPTIONS AVAILABLE WITH EACH CRASH MODULE ARE SHOWN BELOW 


MODULE MESSAGES MEMORY DUMPING 

NCRASH NO NO 

MCRASH YES no 

TC11iCR No YES -- TC11 DECTAPE ** 
TC11CM YES YES -- TCi1 DECTAPE ¥**# 
TUIOCR NO YES == TUi0 MAGTAPE 
TUL0OCM YES YES «= TU10 MAGTAPE 
TUL6CR NO YES *- TU16 MAGTAPE 
TU16CM YES YES == TU16 MAGTAPE 
RKOSCR NO YES -= RKOS DISK ++ 
RKO5CM YES YES == RKOS DISK ++ 


*¥ TC11 DECTAPE CAN NOT DUMP MORE THAN 124K WORDS 
++ RKO5 DISK CAN NOT DUMP MORE THAN 1152K WORDS 


THE DEFAULT UNIT NUMBERS FOR THE RESPECTIVE DEVICES ARE: 
TC11 == #7 
TU10 =~ #7 
TU16 <== #0 
RKOS == #1 
THE DEFAULT MAY BE CHANGED BY USING THE TKB GLOBAL PATCH OPTION 
TO MODIFY THE CRASH UNIT NUMBER (.CRSUN) AS DESIRED. FOR EXAMPLE, 
TO CHANGE THE UNIT NUMBER TO 2, INCLUDE THE FOLLOWING LINE: 
GBLPAT=EXEC:.CRSUN:2 


11,15] EXEC/LB:NCRASH 


ee ewe TO Ve Te Fe Te Be VE Ve Be Ne TE Te WS Te TH Ve Be VE Ve To Ve Ve Te Yo TE Te Ye Te Ye Ve Yo Ve Te Ve TA VS Ne Le Be WE Be LE Ta Ye Te BO Te Ve TO Te Ye Ve SN “SH TO Ve “NO Te te “ee Te 


(11,15JEXEC/LB:LVEND 
£11,15)EXEC/LB:SCOMM 


TKB15.CMD FILE 


/ 

STACK=0 

UNITS=0 
EXTSCT=:130000 

3 GBLPAT=EXEC: .CRSUN:0 
/ 


** NOTE ** 
WHENEVER THE EXECUTIVE IS REBUILT USING THE COMMAND FILE [11,15] TKB15.CMD 


THE BOOTSTRAPS MUST ALSO BE REBUILT USING [(11-17])BUOOTSBLD.CMD BEFORE 
PERFORMING A SYSTEM GENERATION TO INCLUDE THE NEW EXECUTIVE IN THE STSTEM. 


we Me Ve Se Ye Se te 


APPENDIX C 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


This appendix contains sample output from error logging and the format 
of records in the ERROR.SYS file produced by the preanalyzer (PRE). 


C.1 SAMPLE ERROR LOGGING OUTPUT 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


RSX 11 SYSTEM ERROR REPORT COMPILED AT 20-AUG-75 13:48:53 PAGE 15 


KREKKEKEKEEKKEKEKEKERKEKEREKEREEKEKEREREKEEKERKEKEKEKKEKKEKEKKKKKKEKEK 


TAPE HARDWARE ERROR 


LOGGED AT 12-AUG-75 10:19:06 ERROR NUMBER 6. 
HRI KR EEK REE REE RARE ERE KERR EERE EERE REE REREREREREKERKKEKE 


TAPE PARAMETERS 


UNIT NAME DT1 

VOLUME LABEL 

VOLUME OWNER UIC 1,1 

DEVICE TYPE ~ TU56 UNIT-1 CONTROLLER-O 
TAPE REGISTERS AT ERROR TIME 

TCST 04034 SELECTION ERROR! 

TCCM 104702 

TCWC 177400 

TCBA 113534 

TCDT 000007 


ERROR DIAGNOSIS 
RECOVERED 
SELECTION ERROR? 


RETRIES PERFORMED 0. 
USER TASK PARAMETERS 
TASK NAME F11ACP 
TASK UIC 2,2 
PHYSICAL START ADDRESS 102200 
USER FUNCTION REQUESTED WRITE (400) 


FUNCTION INTERPRETED FROM REGISTERS READ BLOCK NUMBER REVERSE 
PHYSICAL BUFFER ADDRESS START 113534 


TRANSFER SIZE IN BYTES 1000 
LOGICAL LOCK NUMBER AT IO GO 2 
COUNT OF IO IN PROGRESS i. 
COUNT OF IO PENDING is 
NUMBER OF FUNCTIONS ISSUED TO THIS UNIT 66 


VECTORS WITH ACTIVE IO 


RRKKKKEKEKEKEKEKEEEEKEKEEKEEKEEREEEKEREEEREKEEEEEREREEEREEKEKKKK EKA 


PRE ANALYZER RUN 


AT 12-AUG-75 10:21:01 
KKK KKK REE REE ERE REE KEE KER EERE ERE REE REKEREEERERRRERKE 


1Included only if /DE switch is specified. 
2System information. 


Figure c-l Tape Error Report 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


RSX 11 SYSTEM ERROR REPORT COMPILED AT 20-AUG-75 13:48:04 PAGE 9. 


RKEEKEKEKREKEERKEKREKEREREKEEKRREEKEEEREKEKREERERKEKEEEEKERKEEREERKREKKEKE 


MEMORY PARITY ERROR 


LOGGED AT 12-AUG-75 10:16:27 ERROR NUMBER 13. 
KKK KKK IKKE RRA KKK EKER EERE KEKE RR RE REE KEE REE REREREEKEKKKE 


MEMORY REGISTERS AT ERROR TIME 


PARITY CSR ADDRESS 172124 

PARITY CSR CONTENTS 000000 
PROCESSOR STATUS WORD PRIOR TO THIS ERROR 174000 
PHYSICAL START ADDRESS OF ERRING TASK 171500 


PROGRAM COUNTER PRIOR TO THIS ERROR 254 


ERROR DIAGNOSIS 

11/45 MEMORY PARITY ERROR 

AT LOCATION OXX 

WITH MEMORY MANAGEMENT REGISTER 0 ACTIVE 
IN USER MODE 


KHKKKKKKE KEKE KEKE KEKE ERE EK ERE REE EKER EKEREEEKE | 


ERROR LOGGING SYSTEM STOPPED 
AT 12-AUG-75 10:17:06 


KREKKKEKKEKEKEKEKEEKKEEKKEEEKRKEREKEEKEREEREREREREKRKEEKKKEKEKKREKE 


KHKKEKKKKKKA KEKE KAKA EREEREEKEKHEEKEKKEKKKKR KKK! 


ERROR LOGGING SYSTEM STARTED 


AT 12-AUG-75 10:18:35 
KKK KKK KEKE EEK EERE KKK REE EKER EERE ERK REREREEREEKRKEREREREKER 


1System information. 


Figure C-2 Memory Parity Error (No /DE Switch) 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


RSX 11 SYSTEM ERROR REPORT COMPILED AT 28@AUG=75 15348294 


BIOSIS III III III III TOOT OI TOI TOTO TOT TIE 
MEMORY PARITY ERROR 

LOGGED AT L2"AUGe75 10216827 ERROR NUMBER 15, 
SOI IG IIIS II IOI IOI OT ITT TOT TTT TOTO TT TTT TAI 


MEMORY REGISTERS AT ERROR TIME 


PARITY CSR ADDRESS 172124 

PARITY CSR CONTENTS 222080 
PROCESSOR STATUS WORD PRIOR TO THIS ERROR 174098 
PHYSICAL START ADDRESS OF ERRING TASK 171500 
PROGRAM COUNTER PRIOR To THIS ERROR 254 


ERROR DIAGNOSIS 

14/45 MEMORY PARITY ERROR 

AT LOCATION @Xx 

WITH MEMORY MANAGEMENT REGISTER © ACTIVE 
IN USER MODE 


SOI IID IG IOI III SISO IOI IOI IOI TO TTT TON ANAT AN 
ERROR LOGGING SYSTEM STOPED 

AT 12"AUG@75 10317306 

SOOO IIIS IIIS II IIS TI TTT TO OTT TOIT AIA 


SSIS SEAARES PARAS REAR RENNES SEAS AAA AEAES ORES A RAR AE RER NOES O RS 
ERROR LOGGING SYSTEM STARTED 

AT 12"AUG@75 10518235 

SO IOS IOI III II IOI IIE IOI III ITO III TOTO TT TET TOI IO 


‘Included only if /DE switch is specified. 


Figure C-3 Memory Parity Error (/DE Switch Specified) 


Cc-4 


PAGE 9, 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


C.2 FORMAT OF RECORDS IN ERROR.SYS FILE 


HEADER FIELD (HF) 
ALL RECORDS CONTAIN A HEADER FIELD. WORDS §-7 OF THE HEADER 
FIELD ARE STANDARD FOR ALL HEADER FIELDS. 


HIGH BYTE LOW BYTE 
SIZE OF HEADER FIELD 


VARIABLE ACCORDING TO ENTRY TYPE 


THE FOLLOWING IS A DESCRIPTION OF WORD 8-N OF THE HEADER 
FIELDS WHICH ARE PRESENTLY USED. 


ENTRY TYPE $48 ERRLOG STARTUP, TYPE 41 ERRLOG SHUTDOWN, 
TYPE 43 SOURCE FILE RE-INITIALIZE 


POINTER TO INITIALIZE COMMENTS FIELD (ICF) 
IF ZERO FIELD NOT PRESENT. CURRENTLY = 9 

ll | POINTER TO SYSTEM HARDWARE HISTORY FIELD (SHF) 
IF ZERO FIELD NOT PRESENT. CURRENTLY = 2 


ENTRY TYPE 1, DEVICE ERROR BIT SET 


/64 PHYSICAL BASE ADDRESS OF TASK WHICH HAD 
ARITY ERROR 
OINTER TO DEVICE REGISTER FIELD 


DEVICE 
REGISTER 
FIELD 


PROGRAM 
FIELD 


VOLUME 
FIELD 


[ew ] SIZE OF PROGRAM FIELD 


= 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


DEVICE REGISTER FIELD (DRF) 

THIS FIELD IS A COPY OF THE DEVICE REGISTERS WHICH REPRESENT 
THE STATE OF THE DEVICE AND CONTROLLER AT INTERRUPT TIME. THIS 
FIELD IS PRESENT WITH MOST DEVICE RELATED ERRORS. 


WD HIGH BYTE LOW BYTE 
|g SIZE OF DEVICE REGISTER FIELD 
DEVICE AND CONTROLLER REGISTERS AS SEEN ON 

THE UNIBUS 


PROGRAM FIELD (PGF) 

THIS PROGRAM FIELD IS USED FOR DEVICE ERROR ENTRIES. 

THIS FIELD IS PRESENT WITH ERRORS WHICH CAN BE TRACED TO A PROGRAM 
WD ___HIGH BYTE LOW BYTE 


18 BIT ADDRESS SY FORMAT = 1 


STEM 


: 
STEM 


4 = 22 BIT ADDRESS SY 


2-3 TASK NAME (6 CHARACTER RAD5Q) 


pa TASK uic 
PROGRAMMER GROUP CODE PROGRAMMER CODE 


| 5 |1/64 LOAD IMAGE BASE ADDRESS 
(6 |. USER FUNCTION CODE 


6 USER FUNCTION PARAMETER WORDS (DEVICE SPECIFIC) i 
13 


MAXIMUM # OF RETRIES # OF RETRIES REMAINING 
TO BE DONE 


14 |COUNT OF THIS TASK'S I/O IN PROGRESS 
COUNT OF THIS TASK'S I/O WAITING IN A QUEUE 


VOLUME FIELD (VLF) 

THIS FIELD IS USED TO SOFTWARE IDENTIFY THE PHYSICAL MEDIA 
WHICH IS MOUNTED ON A DEVICE. WHICH PACK OF MULTIPLE PACKS 
WHICH WAS ON THE DEVICE WHICH ERRED. 


HIGH BYTE LO 


WD W BYTE 
ro SIZE OF VOLUME FIELD | 
(1 


VOLUME OWNER uic VOLUME OWNER uic 
GROUP NUMBER PROGRAMMER NUMBER 


STATISTICS FIELD (STF) 
THIS FIELD REPRESENTS THE RATE OF ERRORS ON A DEVICE OR THE 
USAGE OF A DEVICE. THIS FIELD IS PRESENT FOR DEVICE ERRORS 


LOW BYTE 
STaTistTics|@ [ STEER 
NOT USED FORMAT = 2 


FIELD 


| 2-3 | NUMBER OF TIMES THE GO BIT WAS SET FOR THIS UNIT 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


BUS ACTIVITY FIELD (BAF) 

THIS FIELD REPRESENTS THE ACTIVITY WHICH WAS CONCURRENT ON 
THE UNIBUS AT THE TIME OF ERROR. THIS FIELD IS PRESENT TO 
ASSIST IN THE DETECTION OF BUS INTERACTION PROBLEMS. 


HIGH BYTE LOW BYTE 

BUS SIZE 

ACTIVITY (NOT USED) FORMAT = 1 

FIELD 9|A BIT SET IN EACH WORD REPRESENTS ACTIVITY 
ON THAT VECTOR I.E., WORD 1 BIT % = VECTOR 
19 y e 


NOTE 1 


ENTRY TYPES ARE DIVIDED INTO MAJOR CATEGORIES. THESE MAJOR 
CATEGORIES CORRESPOND TO A DIVISION WHICH DETECTED THE ERROR. 


THE FOLLOWING MAJOR CATEGORIES ARE DEFINED WITH THE RANGE OF 
ENTRY CODE NUMBERS. 


GOD UNDEFINED 

9@1 - 937 HARDWARE ERRORS 

G49 - $77 SYSTEM 

THE FOLLOWING EXPLICIT ENTRY TYPE CODES ARE DEFINED 


HARDWARE ERRORS 


991 DEVICE ERROR BIT SET 

GB2 MEMORY PARITY ERRORS 

SYSTEM 

G49 ERRLOG START-UP 

Gal ERRLOG SHUT-DOWN 

G43 SOURCE FILE RE-INITIALIZATION 
NOTE 2 


DEVICE CLASSES ARE DIVIDED INTO MAJOR CATEGORIES ACCORDING TO 
THEIR FUNCTION WITHIN THE OPERATING SYSTEM. 


THE FOLLOWING MAJOR CATEGORIES AND THE CODE NUMBER RANGES ARE 
DEFINED 


OOo UNDEFINED 
$91 - $37 MASS STORAGE 
296 - 237 CPU OPTIONS/SYSTEMS 


THE FOLLOWING EXPLICIT DEVICE CLASS NUMBERS ARE DEFINED 
MASS STORAGE 

G91 DISKS 

GG2 TAPES 


CPU OPTIONS/SYSTEMS 
296 PROCESSOR 


ERROR LOGGING SAMPLE OUTPUT AND DATA RECORD FORMATS 


NOTE 3 

DEVICE TYPES ARE FURTHER DEFINITION OF THE DEVICE CLASSES. 
THEREFORE A WHOLE SERIES OF DEVICE TYPE NUMBERS EXIST WITH 
EACH DEVICE CLASS. 


THE FOLLOWING DEVICE TYPES ARE PRESENTLY DEFINED BY DEVICE 
CLASS 


DEVICE TYPE CODES FOR DEVICE CLASS $91 (DISK) 


GOB UNDEFINED 

GO1 RK#5/RKG3 

G2 RPG3 

993 RF11 

GO4 RS#4 

995 RS#3 

G96 RPQ4 

G87 RP§2 ON RP11C CONTROLLER 
DEVICE TYPE CODES FOR DEVICE CLASS 992 (TAPES) 
GID UNDEFINED 

991 TU56 

G2 TU1LG 

G93 TU1L6 


DEVICE TYPE CODES FOR DEVICE CLASS 2% (PROCESSOR) 
IGG UNDEFINED 

G1 11/45 

BP2 11/79 


APPENDIX D 


11/70 PARITY ERROR RESPONSE 


ACTION* 


SOURCE DISABLE BITS SET 
OF CYCLE ALL TRAPS DISABLE WARNING ALL TRAPS IN ERROR 
CYCLE TYPE TYPE OF ERROR ENABLED TRAPS (CROO 1) (CR 01:00 3) REGISTER 
DATI/P MAIN BUS TIMEOUT ABORT ABORT ABORT 15 118 
MAIN BUS PARITY ABORT ABORT ABORT £50 EY: 1. 
MAIN MEM WANTED WD ABORT ABORT ABORT 15 11 2 or 3 
MAIN MEM OTHER WD TRAP NO ACTION NO ACTION 11 2 or 3 
CPU to FAST MEM ADDRESS TRAP NO ACTION NO ACTION 114 or 5 
CACHE FAST MEM DATA TRAP NO ACTION NO ACTION 11 6 or 7 
DATO/B MAIN BUS TIMEOUT ABORT ABORT ABORT 15 110 
MAIN BUS PARITY ABORT ABORT ABORT £5 
DATI/P MAIN BUS TIMEOUT UNIBUS UNIBUS UNIBUS NONE 
TIMEOUT TIMEOUT TIMEOUT 
MAIN BUS PARITY UNIBUS UNIBUS UNIBUS 10 1 
TIMEOUT TIMEOUT TIMEOUT 
MAIN MEM WANTED WD UNIBUS UNIBUS UNIBUS PB 13 10 2 or 3 
PB TRAP PB, TRAP 
UNIBUS MAIN MEM OTHER WD TRAP NO ACTION NO ACTION 10 2 or 3 
(thru FAST MEM ADDRESS TRAP NO ACTION NO ACTION 10 4 or 5 
MAP) to FAST MEM DATA TRAP NO ACTION NO ACTION 10 6 or 7 
CACHE 
DATO/B MAIN BUS TIMEOUT UNIBUS UNIBUS UNIBUS 10 8 
TIMEOUT TIMEOUT TIMEOUT 
TRAP 
MAIN BUS PARITY UNIBUS UNIBUS UNIBUS 10 1 
TIMEOUT TIMEOUT TIMEOUT 
TRAP 
FAST MEM ADDRESS TRAP NO ACTION NO ACTION 10 4 or 5 
DATI/P MAIN BUS TIMEOUT UNIBUS UNIBUS UNIBUS NONE 
TIMEOUT TIMEOUT TIMEOUT 
ABORT TO 4 ABORT TO 4 
CPU to MAIN BUS PARITY UNIBUS UNIBUS TIMEOUT  UNIBUS TIME- 10 1 
UNIBUS TIMEOUT ABORT TO 4 OUT, ABORT 
thru ABORT TO 4 TO 4 
MAP to MAIN MEM WANTED WD  UNIBUS UNIBUS PARITY UNIBUS PARITY 13 10 9 2 or 3 
CACHE PARITY ABORT TO 114 ABORT TO 114 
ABORT TO 
114 
MAIN MEM OTHER WD TRAP NO ACTION NO ACTION 10 2 or 3 
FAST MEM ADDRESS TRAP NO ACTION NO ACTION 10 4 or 5 
FAST MEM DATA TRAP NO ACTION NO ACTION 10 6 or 7 


11/70 PARITY ERROR RESPONSE 


SOURCE 
OF CYCLE 
CYCLE TYPE TYPE OF ERROR 


DATAO/B MAIN BUS TIMEOUT 


MAIN BUS PARITY 


FAST MEM ADDRESS 


*ALL TRAPS VECTOR TO 114 


ALL TRAPS DISABLE WARNING 


ENABLED TRAPS (CROO 1) 
UNIBUS UNIBUS 
TIMEOUT TIMEOUT 

ABORT TO 4 ABORT TO 4 
UNIBUS UNIBUS 
TIMEOUT TIMEOUT 

ABORT TO 4 ABORT TO 4 
TRAP 

TRAP NO ACTION 


NOTES: 1. These tables only cover single errors. 


DISABLE 
ALL TRAPS 
(CR 01:00 3) 


UNIBUS 
TIMEOUT 
ABORT TO 4 
UNIBUS 
TIMEOUT, 
ABORT TO 4 


NO ACTION 


BITS SET 
IN ERROR 
REGISTER 


101 


10 4 or 5 


2. The processor also will abort to 114 when doing DATI/P cycles on the 
In these cases, bit 9 sets in the 


UNIBUS and the device asserts PB. 


error register. 


3. Errors on MASSBUS cycles are handled by the MASSBUS controls, and 
have an effect on the error register. 


Abnormal termination of error 
logging, 8-5 
ACCABT task, 2-9 
ACCABT error message, .2-14 
Access count for SGAs, 5-1, 5-5 
ACCOFF error messages, 2-14 
ACCOFF task, 2-9 
ACCLOG error messages, 2-12 
ACCLOG task, 2-3 
Accounting, 
analysis task (ACCRPT), 2-4 
disk storage statistics, 
(PIP), 2-11 
error messages, 2-12 
function description of, 2-3 
initiation of, 2-9 
logging task (ACCLOG), 2-3 
operational information, 2-7 
output from, 2-2 


rebuilding utilities for, 2-10 


Switches, 2-19 

termination of, 2-9 

use of UICS, 2-3, 2-12 
ACCRPT error messages, 2-13 
ACCRPT task, 2-4 
ACCTSn.DAT file format, 2-8 
ACCTS.TOT file format, 2-5, 2-6 
Ancillary control processors 

(ACPs), 9-1, 9-3 

Asynchronous System Trap (AST), 

core dump of queues, 6-5 
Automatic output spooling, 3-1 

disabling, 3-3 

enabling, 3-3 

program conventions for, 3-2 

system requirements for, 3-2 

technigue used, 3-3 


Batch, use of with input 
spooling, 3-15 
aborting, 3-17 


Calling CDA, 6-18 
Card deck format for input 
spooling, 3-13 
CDA (core dump analyzer), 6-1 
CDA sample listing, A-2 
CDA switches, 
/ALL (ALL), 6-4 
/ASQ (AST queues), 6-5 
/ATL (active task list), 6-6 


INDEX 


CDA switches (cont.), 
/BAT (batch command buffers), 
6-7 
/CKQ (clock queue), 6-8 
/DMP (dump), 6-6 
/FTL (fixed task list), 6-9 
/GCD (global common 
directory), 6-16 
/HDR (task headers), 6-11 
/MCR (MCR command buffers), 
6-11 
/POL (dump of system node 
pool), 6-12 
/PUD (PUDS and I/O request 
queues), 6-12 
/SGA (Shareable global 
area), 6-13 
/SQR (SEND/RECEIVE gueues), 
6-13 
/STD (system task directory), 
summary of, 6-14 
/TAS (dump of task’s address 
space), 6-14 
/TPD (task partition 
Girectory), 6-15 
/VFY (verification of node 
pool), 6-16 
Characteristics of SGAs, 5-5 
Checkpointable tasklist (CTL), 
4-1, 4-2 
Checkpointing capability, 4-1 
Clock Queue, 
core dump of, 6-8 
Core dump analyzer (CDA), 6-21 
command string examples, 6-19 
crash stack, 6-2 
error messages, 6-21 
input to CDA, 6-22 
kernel stack, 6-3 
operational information, 6-17 
and see CDA switches, 
system communication area, 6-3 
Crash, forcing of, 6-2z 
CREATE card for input spooling, 
3-14 
CTL (checkpointable task list), 
4-] 


Despooler algorithm, 3-9 
Despooling, 
delete/preserve indicator, 3-7 
error recovery procedures, 
3-12 


Index-1 


Despooling (cont.), 

multiple copies, 3-7 

multiple device, despooler, 
3-4 

multiple form types, 3-6 

priority, 3-6 

Single device despooler, 3-4 

SPR (queue manager), 3-7 

SPR2 (multiple device 
despooler), 3-8 


INDEX (CONT. ) 


Initiating accounting, 2-9 
Input spooling, 3-12 
CREATE card, 3-14 
disabling of, 3-13 
enabling of, 3-13 
input deck format, 3-13 
use with batch, 3-15 
Input to CDA, 6-22 
Installed reference count for 
SGAs, 5-4 


Despooling task priorities, 3-19 Installing an SGA, 5-3 


QUE task, 3-19 
SPR task, 3-18 
SPR2 task, 3-19 
Disabling input spooling, 3-13 


Enabling automatic output 
spooling, 3-3 
Enabling input spooling, 3-13 
End-of-file card, 3-15 
Error logging, 
abnormal termination of, 8-5 
device-specific log, 8-2 
error messages, 8-19 
functional description, 8-4 
operational information, 8-4 
summary log, 8-3 
termination of, 8-9 
Error recovery procedures for 
despooling, 3-11 
Executive debugging aids, 19-1 
ODT, 16-1 
Trace, 18-3 


FIIACP, tailoring of, 9-3 
File formats, 
ACCTSn.DAT, 2-8 
ACCTS.TOT, 2-5, 2-6 
CDA input, 6-22 
Files-1]1 ACP, 9-2 
FORTRAN file specification for 
spooling, 3-4 
Functional description 
accounting, 2-3 
error logging, 8-4 


GCD (global common directory), 


5-4 
General (nonprivileged) user, 
1-2 . 
Global common directory (GCD), 
5-4 


INSTALL switch for accounting 
(/TIM), 2-10 


SJOB card, 3-16 


Linking CDA into the Executive, 


6-17 
7LRU switch on INITVOL and 
MOUNT, 9-3 


Magnetic tape FCP, 9-3 
Memory required list (MRL), 4-1 
Multiple device despooler, 3-4 
OPR command, 3-5 
QUE command, 3-5 


Operational information 
accounting, 2-7 
error logging, 8-4 
OPR command, 3-5 
Output spooling (see automatic 
output spooling) 


Parity support, 11-1 

Password protection, 1-2, 1-3 

PIP disk storage statistics, 
2-11 

PRINTS macro call, 3-8 

Priorities of despooling tasks, 
3-198 

Privileged user, definition of, 
1-3 

Program conventions for 
automatic output spooling, 
3-2 

PSE error messages, 8-19 

PUD reguired for spooling, 3-2 

PWD command, 1-3 


Index-2 


INDEX (CONT. ) 


QUE command, 3-5 SYE error message, 8-11 
Queue, clock switch to CDA, 6-8 System requirements for output 
Queue manager (SPR), 3-7 spooling, 3-2 


System requirements for input 
spooling, 3-12 


Removing an SGA, 5-3 
Running ERRLOG task, 8-6 ear 
Running PSE task, 8-6 Task building an SGA, 5-3 
Running SYE task, 8-7 Task builder switch for 
accounting, (TA), 2-19 
/TB switch for disk storage, 
statistics, 2-11 


Shareable global area (SGA), 5-1 Terminating accounting, 2-9 
characteristics of, 5-5 Terminating error logging, 8-9 
fragmentation and lockouts, Time-scheduled partitions, 7-1 

5-6 /TIM INSTALL switch 
installation of, 5-3 (accounting), 2-18 
removal of, 5-3 TKB15.CMD file, 6-15, B-1 


task building of, 5-3 
writing an, 5-2 
Single device despooler, 3-4 


SP device, 3-2 UFD command, 1-2 

Spoolina, see UFD required for spooling, 3-2 
automatic output spooling, 3-1 UICs and accounting, 2-3, 2-13 
despooling, 3-4 UICs and password protection, 
input spooling, 3-12 1-2, 1-3 

Spooling PUD, 3-2 Utilities, rebuilding to be 

Spooling UFD, 3-2 accounted, 2-16 

SPR (queue manager), 3-7 UTLACCBLD.BIS file, 2-198 


SPR2 (multiple device 
despooler), 3-7 
Summary of CDA switches, 6-18 
SYE error analyzer, 8-4 Writing an SGA, 5-2 


Index-3 


RSX-11D 
System Manager's Guide 
DEC-11-OXSMA-C=-D 


READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
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required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 
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